node nvm

Posted 2020-08-30 jhhu

 

nvm 是 Mac 下的 node 管理工具，有点类似管理 Ruby 的 rvm，如果是需要管理 Windows 下的 node，官方推荐是使用 nvmw 或 nvm-windows 。

以下具体说下 Mac 系统中的安装与使用细节（Windows 系统仅供类比参考）。

一、卸载已安装到全局的 node/npm

如果之前是在官网下载的 node 安装包，运行后会自动安装在全局目录，其中

node 命令在 /usr/local/bin/node ，npm 命令在全局 node_modules 目录中，具体路径为 /usr/local/lib/node_modules/npm

安装 nvm 之后最好先删除下已安装的 node 和全局 node 模块：

npm ls -g --depth=0 #查看已经安装在全局的模块，以便删除这些全局模块后再按照不同的 node 版本重新进行全局安装

sudo rm -rf /usr/local/lib/node_modules #删除全局 node_modules 目录
sudo rm /usr/local/bin/node #删除 node
cd  /usr/local/bin && ls -l | grep "../lib/node_modules/" | awk ‘{print $9}‘| xargs rm #删除全局 node 模块注册的软链

二、安装 nvm

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.29.0/install.sh | bash

安装完成后请重新打开终端环境，Mac 下推荐使用 oh-my-zsh 代替默认的 bash shell。

三、安装切换各版本 node/npm

nvm install stable #安装最新稳定版 node，现在是 5.0.0
nvm install 4.2.2 #安装 4.2.2 版本
nvm install 0.12.7 #安装 0.12.7 版本

# 特别说明：以下模块安装仅供演示说明，并非必须安装模块
nvm use 0 #切换至 0.12.7 版本
npm install -g mz-fis #安装 mz-fis 模块至全局目录，安装完成的路径是 /Users/<你的用户名>/.nvm/versions/node/v0.12.7/lib/mz-fis
nvm use 4 #切换至 4.2.2 版本
npm install -g react-native-cli #安装 react-native-cli 模块至全局目录，安装完成的路径是 /Users/<你的用户名>/.nvm/versions/node/v4.2.2/lib/react-native-cli

nvm alias default 0.12.7 #设置默认 node 版本为 0.12.7

四、使用 .nvmrc 文件配置项目所使用的 node 版本

如果你的默认 node 版本（通过 nvm alias 命令设置的）与项目所需的版本不同，则可在项目根目录或其任意父级目录中创建 .nvmrc 文件，在文件中指定使用的 node 版本号，例如：

cd <项目根目录>  #进入项目根目录
echo 4 > .nvmrc #添加 .nvmrc 文件
nvm use #无需指定版本号，会自动使用 .nvmrc 文件中配置的版本
node -v #查看 node 是否切换为对应版本

五、nvm 与 n 的区别

node 版本管理工具还有一个是 TJ 大神的 n 命令，n 命令是作为一个 node 的模块而存在，而 nvm 是一个独立于 node/npm 的外部 shell 脚本，因此 n 命令相比 nvm 更加局限。

由于 npm 安装的模块路径均为 /usr/local/lib/node_modules ，当使用 n 切换不同的 node 版本时，实际上会共用全局的 node/npm 目录。 因此不能很好的满足『按不同 node 版本使用不同全局 node 模块』的需求。

因此建议各位尽早开始使用 nvm ，以免出现全局模块无法更新的问题

 

目前主流的node版本管理工具有两种，nvm和n。两者差异挺大的，具体分析可以参考一下淘宝FED团队的一篇文章：

管理 node 版本，选择 nvm 还是 n？

总的来说，nvm有点类似于 Python 的 virtualenv 或者 Ruby 的 rvm，每个node版本的模块都会被安装在各自版本的沙箱里面（因此切换版本后模块需重新安装），因此考虑到需要时常对node版本进行切换测试兼容性和一些模块对node版本的限制，我选择了使用nvm作为管理工具，下面就来说说nvm的安装和使用过程。

安装

一开始，我像往常一样在 oh-my-zsh 中选择了使用 Homebrew 来安装nvm，完成后却发现它被全局安装了，这就造成了后面使用上的一点问题，具体问题可参考 Github 上的一个 issue 。

然后我就又用 Homebrew 把它给卸掉了，还是决定找找看它的文档， Github 上找到 这里 。

清楚看到文档中 Installation 那一小节有一句 Homebrew installation is not supported. ，由此可见，没事儿还是要多看看文档。

正式进入安装过程：

我选择了使用 curl 来安装：

url -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.2/install.sh | bash

完成后nvm就被安装在了 ~/.nvm 下啦，接下来就需要配一下环境变量了，如果你也使用了 zsh 的话，就需要在 ~/.zshrc 这个配置文件中配置，否则就找找看 ~/.bash_profile 或者 ~/.profile 吧。

打开 ~/.zshrc ，在最后一行加上：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm

这一步的作用是每次新打开一个bash，nvm都会被自动添加到环境变量中了。

完成后输入 source ~/.zshrc 重新启动一下配置。

输入 nvm 可以看到如下信息：

?  ~  nvm

Node Version Manager

Note: <version> refers to any version-like string nvm understands. This includes:
  - full or partial version numbers, starting with an optional "v" (0.10, v0.1.2, v1)
  - default (built-in) aliases: node, stable, unstable, iojs, system
  - custom aliases you define with `nvm alias foo`

Usage:
  nvm help                                  Show this message
  nvm --version                             Print out the latest released version of nvm
  nvm install [-s] <version>                Download and install a <version>, [-s] from source. Uses .nvmrc if available
    --reinstall-packages-from=<version>     When installing, reinstall packages installed in <node|iojs|node version number>
  nvm uninstall <version>                   Uninstall a version
  nvm use [--silent] <version>              Modify PATH to use <version>. Uses .nvmrc if available
  nvm exec [--silent] <version> [<command>] Run <command> on <version>. Uses .nvmrc if available
  nvm run [--silent] <version> [<args>]     Run `node` on <version> with <args> as arguments. Uses .nvmrc if available
  nvm current                               Display currently activated version
  nvm ls                                    List installed versions
  nvm ls <version>                          List versions matching a given description
  nvm ls-remote                             List remote versions available for install
  nvm version <version>                     Resolve the given description to a single local version
  nvm version-remote <version>              Resolve the given description to a single remote version
  nvm deactivate                            Undo effects of `nvm` on current shell
  nvm alias [<pattern>]                     Show all aliases beginning with <pattern>
  nvm alias <name> <version>                Set an alias named <name> pointing to <version>
  nvm unalias <name>                        Deletes the alias named <name>
  nvm reinstall-packages <version>          Reinstall global `npm` packages contained in <version> to current version
  nvm unload                                Unload `nvm` from shell
  nvm which [<version>]                     Display path to installed node version. Uses .nvmrc if available

Example:
  nvm install v0.10.32                  Install a specific version number
  nvm use 0.10                          Use the latest available 0.10.x release
  nvm run 0.10.32 app.js                Run app.js using node v0.10.32
  nvm exec 0.10.32 node app.js          Run `node app.js` with the PATH pointing to node v0.10.32
  nvm alias default 0.10.32             Set default node version on a shell

Note:
  to remove, delete, or uninstall nvm - just remove the `$NVM_DIR` folder (usually `~/.nvm`)

至此，nvm的安装就算是告一段落了，下面我们就来看一下如何使用它来对node版本进行切换使用。

使用

其实，上述最后一步打印出的信息已经可以清楚看到nvm的全部命令。

各项命令的详细用法及含义可参考上文提到的 nvm文档 。

接下来就轮到安装我们的主角node大哥了。

首先我们可以使用 nvm ls-remote 看一下node有哪些版本可以安装：

?  ~  nvm ls-remote
            v0.1.14
            v0.1.15
            v0.1.16
            ...

Note：由于在写文章的时候网络有问题，无法展示所有结果出来，上面代码示意一下，正确情况下会显示非常多版本出来，大家都知道node更新速度非常非常快。

我常用的node版本是4.1.0，因此首先安装这个版本：

$ nvm install v4.1.0
######################################################################## 100.0%

Now using node v4.1.0

同时安装一下最新版来测试nvm的版本管理功能：

$ nvm install v5.5.0
######################################################################## 100.0%

Now using node v5.5.0

使用nvm轻松切换node版本

在介绍使用方法前，简单说明一下nvm的工作原理：

按照我上述安装方法的话，nvm会将各个版本的node安装在 ~/.nvm/versions/node 目录下，我们可以打开这个目录看看有些什么东西：

?  ~  ls -a ~/.nvm/versions/node
.      ..     v4.1.0 v5.5.0

事实上 v4.1.0 和 v5.5.0 这两个目录分别存放node的binary档，nvm会在 $PATH 前面安插指定版本的目录，透过这种方式在使用node命令时就会用指定版本的node来运行了。

可以确认实际的 $PATH 看看：

?  ~  echo $PATH
/Users/***/.nvm/versions/node/v5.5.0/bin:...

由于刚刚我们通过nvm安装node，会自动把最后安装的版本设为当前使用的版本，因此上述路径结尾会是 .../v5.5.0/bin （还可通过 nvm ls 命令查看当前已安装的所有node版本）。

接下来我们可以使用 nvm use <version> 切换版本：

?  ~  nvm use v4.1.0
Now using node v4.1.0 (npm v2.14.3)
?  ~  node -v
v4.1.0
?  ~  nvm use v5.5.0
Now using node v5.5.0 (npm v3.3.12)
?  ~  node -v
v5.5.0

轻轻松松完成切换！

不过问题来了，这时如果你新打开一个bash，输入 nvm current 会发现显示为 null ，这是因为使用 nvm use 命令只会在当前bash里生效，重新打开一个bash你会发现 $PATH 的值已经不包含刚才的node目录了，要解决这个问题也很简单，使用 nvm alias default <version> 命令来指定一个默认的node版本就ok了，这里我使用了 v4.1.0 作为默认版本：

?  ~  nvm alias default v4.1.0
default -> v4.1.0

此时再打开一个bash输入 nvm current 就会显示为 v4.1.0 了。

小结

以上为我在安装nvm的过程中通过各种资料总结出来的一套简单教程，欢迎大家分享交流！