nvm Node 版本管理器

它是什么

nvm 是 Node.js 的版本管理器。它是一个 shell 脚本，按用户安装、按 shell 使用，所以每个终端都能用不同的 Node.js 版本，而不碰系统里那一份。README 说它能在任何符合 POSIX 的 shell（sh、dash、ksh、zsh 和 bash）上运行，平台包括 unix、macOS 和 Windows WSL。

1. 安装脚本把 nvm 放进 ~/.nvm，并写入你的配置文件
2. nvm install 22 取回那个版本的 Node.js
3. nvm use 22 让当前 shell 的 PATH 指向它
4. .nvmrc 文件写明项目需要的版本
5. 不带版本的 nvm use 会读这个文件

适合谁

同时做几个 Node.js 项目、每个项目要不同版本的开发者。要在旧版和新版 Node.js 上测试库的维护者，以及构建 Docker 镜像或 CI 任务的人，也能用上。在 WSL、Git Bash 和 Cygwin 之外的 Windows 上别用它。对此 README 指向 nvm-windows、nodist 和 nvs，并说 nvm 团队既不支持也不开发它们。

用在哪里

nvm 在符合 POSIX 的 shell 里、于下面这些平台上运行，安装说明给每个平台写了一页，命令都照抄制作者的 README。

• Linux：用 curl 或 wget 运行安装脚本，或者用 Git 安装
• macOS：同一个脚本，要先装好 Xcode 命令行工具
• Windows：通过 WSL，README 还说它应该也能在 Git Bash 或 Cygwin 里用
• Docker 和 CI 任务：设置 BASH_ENV，或者用 README 里给 CI/CD 任务的 Dockerfile
• Alpine Linux：先装额外的软件包，没有 musl 二进制文件时要从源码构建
• Shell：sh、dash、ksh、zsh 和 bash。fish 不受支持，README 列出了别人做的替代品

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按制作者的 README，给每个平台写了一页。安装脚本做了大部分工作。

1. 用 curl 或 wget 运行安装脚本。
2. 关掉终端再打开一个新的，或者 source 你的配置文件。
3. 运行 command -v nvm，应该会输出 nvm。
4. 用 nvm install 安装一个 Node.js 版本。

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

这条命令写的是 v0.40.8，也就是写这份说明时 README 用的版本。请用它现在写的那个。脚本会把 nvm 放进 ~/.nvm，有 git 就用 git，没有就下载，并把 source 行加到它找到的配置文件里。如果它选错了文件，就把 PROFILE 变量设成正确的路径，再运行一遍。

command -v nvm

如何使用

安装一个版本，切换过去，再为新 shell 设好默认版本。README 说你装的第一个版本会成为默认版本。

nvm install node
nvm install 14.7.0
nvm use node
nvm ls
nvm alias default node

第一行装最新版本，第二行装那个确切的版本，所以新旧两个版本可以并排放在同一台机器上。nvm use 改变的是你运行它的那个 shell 里的 PATH，nvm ls 列出你已有的版本。新开的 shell 从 default 别名开始。对一个项目，把版本写进 .nvmrc 文件，这样不带版本的 nvm use 会读它，nvm install 和 nvm which 也一样。

示例

你有几个项目，分别用 Node.js 24、22 和 20。这是 README 的第一个例子。nvm use 只能切换到你已经装好的版本，所以 22 和 20 要先装好：

nvm install 24
node -v
nvm use 22
node -v
nvm use 20
node -v

每个 node -v 会打印你刚切换到的版本。README 的示例输出里，每次安装和切换之后还有一行 Now using node，带着 node 和 npm 的版本。

新手与专家

新手：一个项目可能需要和你机器上不同的 Node.js。nvm 把每个版本放在 ~/.nvm 下它自己的文件夹里，并改变你的 shell 先找到哪一个。nvm 命令是你的 shell 加载的一个函数，不是 PATH 上的程序，所以像 README 说的那样，which nvm 不管用。请改用 command -v nvm。装完之后关掉终端，再开一个新的。在那之前，这个命令可能找不到。README 说用了 nvm 之后，用 npm -g 全局安装模块不需要 sudo。

专家：特殊别名（node、iojs、stable、unstable、current）可用于 nvm install、nvm use、nvm run、nvm exec 和 nvm which。LTS 名称（--lts、lts/*、lts/argon）可用于 install、uninstall、use、exec、run、ls-remote 和 version-remote。nvm install --lts、带 lts/* 的 nvm use，以及 .nvmrc 里写 lts/* 的一行，都会跟着最新的 LTS。每个挑选版本的命令都接受 --only=，可选类别是 alpha、lts、non-lts 和 iojs，NVM_ONLY 设的是默认值。给 nvm install 加上 --reinstall-packages-from=current，会在新版本上重新安装你的全局包，例如 README 的 nvm install --reinstall-packages-from=current 'lts/*'。

NVM_NODEJS_ORG_MIRROR 和 NVM_IOJS_ORG_MIRROR 让 nvm 指向二进制文件的镜像。NVM_AUTH_HEADER 把 Authorization 头只发给镜像，不发给其他主机，但 README 说 BusyBox 的 wget 会把它带到镜像重定向去的任何地方。镜像把下载转给别的主机时，README 建议用 curl。NVM_DIR 里的 default-packages 文件列出每个新版本都要装的包，一行一个名字。你可以加上任何 npm 在命令行里会接受的包参数。nvm install -s 从源码构建，把 NVM_NO_SOURCE_FALLBACK 设为 1，缺少二进制文件时就会报错，而不是悄悄改成源码构建。每个版本一把锁，防止两个 shell 同时安装同一个版本。

注意事项

nvm 按用户安装，在你自己的 shell 里运行，但它的安装步骤会写你的配置文件，还会从网络取文件。

• 配置文件：安装脚本会把 source 行追加到它找到的配置文件里，并给 bash 或 zsh 的配置文件追加一行 bash_completion。PROFILE=/dev/null 能让它不去编辑配置文件
• 下载：nvm 从 nodejs.org 取 Node.js，或者从你设的镜像取。README 的示例安装输出里有一步校验和检查，先是 Computing checksum with sha256sum，然后是 Checksums matched
• 凭据：用 curl（nvm 优先用它）或 GNU Wget 时，NVM_AUTH_HEADER 只发给镜像的网址。README 说 BusyBox 的 wget 会把它带到镜像重定向去的地方。带凭据的镜像网址，nvm 打印时会把凭据遮成 ***@
• 从源码构建：没有二进制文件时，nvm 会编译 Node.js，这很慢，还需要 C++ 工具链
• 一个用户：nvm 只对安装它的那个账号可用，所以这台机器上的其他用户看不到它
• 不受支持：README 说通过 Homebrew 安装和 fish shell 都不受支持，它列出的那些 Windows 工具，nvm 团队也不支持。只有最新的 nvm 版本受支持
• 会冲突的设置：~/.npmrc 里的 prefix、NPM_CONFIG_PREFIX 和 PREFIX 变量，以及 set -e 会引起问题
• 卸载：README 给了手动步骤。运行 nvm unload，删掉安装目录，再把 nvm 的几行从配置文件里去掉
• 许可证：MIT。LICENSE.md 写的是 Tim Caswell（2010）和 Jordan Harband（2014），README 的版权声明写的是 OpenJS Foundation 和 nvm 贡献者