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团队的一篇文章:
总的来说,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的过程中通过各种资料总结出来的一套简单教程,欢迎大家分享交流!