0%

Ubuntu 安装 Node.js 的正确姿势

若要直接查看安装 Node.js 的正确姿势,请拉到文章最后一节。

安装 Node

一般情况下,你第一次安装会这样:

首先到 Node.js 官网下载压缩包。下载得到 node-vXxx.tar.xz,然后解压到 /opt/(适用于共享用户)或 /usr/local/(适用于用户个人资料)。以 /opt/ 为例:

1
2
3
$ cd ~/Download
$ tar -xvf node-v10.16.3-linux-x64.tar.xz
$ sudo mv node-v10.16.3-linux-x64 /opt/node

然后将 /opt/node/bin 添加到 PATH 环境变量中,这样就可以从任意终端中执行 npm 命令了。确保环境变量生效可以执行命令看是否可以查看 node 版本。

1
$ node -v

这种安装方式的问题在于要更新 Node.js 版本时,要再次手动下载压缩包,替换掉原安装路径的内容,并且不小心的话会把已下载的全局 lib 给替换没了。

于是,你在官网上仔细查看,发现了 Installing Node.js via package manager,顿时感觉这包管理器安装才是正经办法。

第二次安装循着指引:

Debian and Ubuntu based Linux distributions, Enterprise Linux/Fedora and Snap packages

Official Node.js binary distributions are provided by NodeSource.

然后根据指导进行安装:

1
2
3
# Using Ubuntu
$ curl -sL https://deb.nodesource.com/setup_13.x | sudo -E bash -
$ sudo apt-get install -y nodejs

这种安装方式下,升级不用手动下载替换了,可以使用一个 npm 模块 n 来升级,可以参见:升级node.js 和 npm。这里不具体展开,因为在这之前就有另外的问题让你头疼。

问题

无法下载

你安装好 Node.js 之后,准备安装一个包,常因为网络原因迟迟无法完成下载。这时候,你需要淘宝 NPM 镜像,使用方法很简单:

  • 可以使用定制的 cnpm (gzip 压缩支持) 命令行工具代替默认的 npm:
1
$ npm install -g cnpm --registry=https://registry.npm.taobao.org
  • 或者直接通过添加 npm 参数 alias 一个新命令:
1
2
3
4
5
6
7
8
9
10
11
$ alias cnpm="npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://npm.taobao.org/dist \
--userconfig=$HOME/.cnpmrc"

# Or alias it in .bashrc or .zshrc
$ echo '#alias for cnpm
alias cnpm="npm --registry=https://registry.npm.taobao.org \
--cache=$HOME/.npm/.cache/cnpm \
--disturl=https://npm.taobao.org/dist \
--userconfig=$HOME/.cnpmrc"' >> ~/.zshrc && source ~/.zshrc

提示无权限

npm 可以把包安装到全局目录,也可以安装到本地本地,常用的工具类的包通常是在命令行中作为命令使用,如果不安装到全局目录则在执行命令时要加上命令的路径,很不方便。

当你尝试全局安装某个包的时候,等待许久最终却看到 EACCES 错误,提示你没有权限写入用于存储全局包和命令的目录,真是令人崩溃。

两种解决办法,一种是修改全局目录为当前用户有权限的目录,具体可参考:更改npm全局包安装目录的解决方案

另一种则是既然没有权限,那加上 sudo 来执行吧:

1
2
$ sudo npm install -g xxxxx
sudo: npm:command not found

会提示找不到命令,需要参考《[译] sudo后使用别名》进行修改:

1
$ alias sudo='sudo '

这样就可以了,但每次安装都要 sudo 其实并不愉快。

事实上,我们一开始就可以选择更合适的 Node.js 的安装方法。

NVM

NVM: 全称是 Node Version Manager, 也就是 Node 版本管理器。

如果你已经安装过了 Node,先把原来的卸载。

1. 卸载 Node, 可能需要 root 权限.

1
$ sudo apt-get remove nodejs

2. 移除你之前的全局 node_modules 包.

1
2
#执行前请确认这个包是否存在这个位置
$ sudo rm -rf /usr/lib/node_moudles

3. 安装 NVM

查看 NVM 的 Github 仓库

1
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash

4. 使用 NVM

1
2
3
4
5
# 将安装最新版本
$ nvm install node
# 列出可安装版本,选择安装某一版本
$ nvm list
$ nvm install 12.14.1 # or 10.10.0, 8.9.1, etc

NVM 最大的好处就是你可以安装多个版本的 node 到你的系统里,直接一条命令就可以切换版本。

1
$ nvm use v13.6.0

更多的使用说明可直接查看 Github 仓库的 README 文档。

现在查看使用 NVM 下载的 node 命令的目录:

1
2
$ where node
/home/mupceet/.nvm/versions/node/v13.6.0/bin/node

可以看到现在使用的目录都是在 Home 目录下,权限问题也就不成问题了,再加上淘宝 NPM 镜像,体验上就很舒服了。

参考链接

  1. Node.js 官网
  2. 升级node.js和npm
  3. 淘宝 NPM 镜像
  4. 更改npm全局包安装目录的解决方案
  5. [译] sudo后使用别名
  6. ubuntu中npm安装全局插件提示没有root管理员权限
  7. nvm-sh/nvm