使用指南

nvm 允许你通过命令行快速安装和使用不同版本的 Node。

示例:

就这么简单！

nvm 是 node.js 的版本管理器，设计为按用户安装，并按 shell 调用。nvm 适用于任何 POSIX 兼容的 shell（sh、dash、ksh、zsh、bash），特别是在这些平台上:UNIX、macOS 和 Windows WSL 。

要安装或更新 nvm ，你应该运行[安装脚本] nvm 。要做到这一点，你可以下载并手动运行脚本，也可以使用以下 curl 或 wget 命令:

运行上述命令中的任何一个都会下载一个脚本并运行它。该脚本将 nvm 库复制到 ~/.nvm，并尝试将下面代码片段中的源行添加到正确的配置文件（~/）。bash_profile，~/.zshrc，~/.profile，或 ~/.bashrc）。

如果存在环境变量 $XDGCONFIGHOME，它将把 nvm 文件放在那里。

你可以将 --no-use 添加到上述脚本的末尾（. nvm ）。sh--no-use）推迟使用 nvm，直到手动 [ 使用 `](#usage) 它。

你可以使用 NVMSOURCE、NVMDIR、PROFILE 和 NODEVERSION 变量来定制安装源、目录、配置文件和版本。例:curl ... | NVMDIR="path/to/nvm"。确保 NVM_DIR 不包含尾随的斜杠。

安装程序可以使用 git、curl 或 wget 下载 nvm，以可用者为准。

在 Linux 上，在运行安装脚本之后，如果你在输入 command -v nvm 之后得到 nvm : command not found 或者没有看到终端的反馈，只需关闭当前的终端，打开一个新的终端，然后再次尝试验证。或者，你可以在命令行中为不同的 shell 运行以下命令:

bash:source ~/.bashrc

zsh:source ~/.zshrc

KSH:. ~/.profile

它们应该接收 nvm 命令。

从 OS X10.9 开始，/usr/bin/git 已经被 Xcode 命令行工具预设，这意味着我们无法正确地检测是否安装了 Git。在运行安装脚本之前，你需要手动安装 Xcode 命令行工具，否则将会失败。（见 #1782）

如果在运行安装脚本后得到 nvm: command not found，原因可能如下:

由于 macOS10.15，默认的 shell 是 zsh，并且 nvm 将查找 .zshrc 以进行更新，默认情况下不会安装任何 shell。用 touch ~/.zshrc 创建一个，然后再次运行安装脚本。

如果使用以前的默认 shell Bash，则系统可能没有设置命令的 .bashprofile 文件。用 touch ~/.bashprofile 创建一个，然后再次运行安装脚本。然后，运行 source ~/.bash_profile 以获取 nvm 命令。

你以前使用过 bash，但是已经安装了 zsh。你需要手动将 这些线条 添加到 ~/.zshrc 并运行 . ~/.zshrc。

你可能需要重新启动终端实例或运行 . ~/.nvm/nvm.sh。重新启动你的终端 / 打开一个新的选项卡 / 窗口，或者运行 Source 命令将加载该命令和新的配置。

如果以上没有帮助，你可能需要重新启动你的终端实例。尝试在终端中打开一个新的选项卡 / 窗口，然后重试。

如果上述方法不能解决问题，你可以尝试以下方法:

如果你使用 Bash，可能是因为你的 .bashprofile（或 ~/.profile）没有正确地获取你的 ~/.bashrc 的源代码。你可以通过向其添加 source ~/ 来解决此问题，或者执行下面的下一步。

尝试将 来自 Install 部分的代码片段 添加到你通常的配置文件（~/）中，这样可以找到正确的 nvm 目录并加载 nvm 。bashprofile，~/.zshrc，~/.profile，或 ~/.bashrc）。

有关此问题和可能的解决方法的更多信息，请 请参阅此处

注意，对于使用 M1 芯片的 Mac，Node 从 V16.0.0 开始提供 ARM64Arch Darwin 封装。在早期版本中，只有 DarwinX64 包可用，但没有 DarwinARM64。如果你在使用 nvm 安装节点时遇到问题，那么你可能希望更新到 v16 或更高版本。

你可以使用一个任务:

要验证 nvm 已安装，请执行以下操作:

如果安装成功，它应该输出 nvm。请注意，which nvm 将不工作，因为 nvm 是源 shell函数，而不是可执行的二进制文件。

注意:在 Linux 上，在运行安装脚本后，如果你得到 nvm: command not found，或者在键入 command -v nvm 后没有看到终端的反馈，只需关闭当前的终端，打开一个新的终端，然后再次尝试验证。

如果你运行的系统没有预打包的可用二进制代码，这意味着你将从它的源代码中安装 NodeJS 或 IO.JS，那么你需要确保你的系统有一个 C++ 编译器。对于 OS X，Xcode 可以工作，对于基于 Debian/Ubuntu/Linux 的 GNU/Linux，build-essential 和 libssl-dev 包可以工作。

注意:nvm 在某些情况下也支持 Windows。它应该通过 WSL（Linux 的 Windows 子系统）工作，这取决于 WSL 的版本。它还应该与 吉巴什 或 Cygwin 一起工作。否则，对于 Windows 来说，存在一些替代方案，这些方案既不受我们的支持，也不是我们开发的:

注:nvm 也不支持fish（参见 #303）。我们既不支持也不开发替代方案:

注意:FreeBSD 仍然存在一些问题，因为 FreeBSD 没有官方的预构建二进制文件，并且编译from source 可能需要 补丁；请参阅问题清单:

注意:在 OS X 上，如果你没有安装 Xcode，也不希望下载 ~4.3GB 的文件，则可以安装 Command Line Tools。你可以看看这篇关于如何做到这一点的博客文章:

注意:在 OS X 上，如果你已经 / 已经安装了一个“系统”节点，并且希望在全球范围内安装模块，请记住:

不支持自定义安装。如果你对 Homebrew-installednvm 有问题，请 brew uninstall，并使用下面的说明安装它，然后再提交问题。

注意:如果你使用 zsh，你可以轻松地将 nvm 安装为 ZSH 插件。安装 zsh-nvm 并运行 nvm upgrade 进行升级。

注意:V1.7 之前的 Git 版本可能面临通过 HTTPS 协议从 GitHub 克隆 源的问题，并且在 V1.6 之前 Git 也有不同的行为，而在 之前的 Git 不能克隆标记，因此最低要求的 Git 版本是 V1.7.10。如果你对我们在这里提到的问题感兴趣，请参阅 GitHub 的 HTTPS 克隆错误 文章。

如果安装了 git（需要 GitV1.7.10+）:

现在将这些行添加到你的 ~/.bashrc、~/.profile 或 ~/.zshrc 文件中，以便在登录时自动获取这些行:（你可能必须添加到上述多个文件中的一个）

对于完全手动安装，执行以下行，首先将 nvm库克隆到 $HOME/.nvm 中，然后加载 nvm:

现在将这些行添加到你的 ~/.bashrc、~/.profile 或 ~/.zshrc 文件中，以便在登录时自动获取这些行:（你可能必须添加到上述多个文件中的一个）

对于使用 git 进行手动升级（需要 GitV1.7.10+）:

要下载、编译和安装最新版本的 Node，请执行以下操作:

要安装特定版本的 Node:

安装的第一个版本成为默认值。新的 shell 将从 node 的默认版本开始（例如 nvm alias default）。

你可以使用 ls-remote 列出可用的版本:

然后在任何新的 shell 中，只需使用已安装的版本:

或者你可以直接运行它:

或者，你也可以在子壳中运行任意命令，使用所需版本的节点:

你还可以获得可执行文件的路径，它被安装在以下位置:

在版本指针（如“14.7”或“16.3”或“12.2 2.1”）之外，你可以使用以下特殊的默认别名:nvm install、nvm use、nvm run、nvm exec、nvm which 等:

Node 有一个 时间表 用于长期支持，你可以在别名和 .nvmrc 文件中引用 LTS 版本，例如，对于最新的 LTS，使用记号 lts/*，对于来自“argon”行的 LTS 版本，使用 lts/argon。此外，以下命令支持 LTS 参数:

每当你的 nvm 本地副本连接到 https://nodejs.org 时，它将为所有可用的 LTS 行重新创建适当的本地别名。这些别名（存储在 $NVM_DIR/alias/lts 下）由 nvm 管理，你不应该修改、删除或创建这些文件--希望你的更改被撤消，并希望干预这些文件会导致可能不受支持的错误。

要获得 Node 的最新 LTS 版本并迁移现有的已安装包，请使用

如果你想要安装 Node.js 的新版本，并从以前的版本迁移 NPM 包:

这将首先使用“ nvm Version Node”来标识要从其中迁移包的当前版本。然后，它解析要从远程服务器安装的新版本并安装它。最后，它运行“ nvm Reinstall-Packages”来将 NPM 包从你以前的 Node 版本重新安装到新的 Node 版本。

你还可以从 Node 的特定版本安装和迁移 NPM 包，如下所示:

请注意，重新安装包不会显式地更新 NPM 版本——这是为了确保 NPM 不会意外地升级到新节点版本的坏版本。

要同时更新 NPM，请添加 --latest-npm 标志，如下所示:

或者，你可以随时运行以下命令，在当前节点版本上获得最新支持的 NPM 版本:

如果你已经得到了一个“NPM 不支持 node.js”的错误，那么你需要（1）恢复到以前的节点版本（ nvm ls&nvm use ，（2）删除新创建的节点版本（ nvm 卸载 ），然后（3）使用 --latest-npm 标志重新运行 nvm install。

如果你在每次安装新版本时都有一个要安装的默认包的列表，那么我们也支持这一点——只需将包名（每行一个）添加到文件 $NVM_DIR/default-packages 中。你可以在命令行中添加 NPM 将接受的任何内容作为包参数。

如果你想要安装 IO.JS :

如果你想要安装新版本的 io.js，并从以前的版本迁移 NPM 包:

对于在 Node 中迁移 NPM 包所提到的指导方针也适用于 IO.JS。

如果要使用 Node 的系统安装版本，可以使用特殊的默认别名“System”:

如果你想查看安装了哪些版本:

如果你想查看可安装的版本:

你可以设置用于显示版本和别名信息的五种颜色。这些颜色代替了默认的颜色。 初始颜色为:g、b、r、e

颜色代码:

如果你希望在终止 shell 之后保持自定义颜色，那么可以在 shell 配置文件中导出 nvm_colors 变量。例如，如果你想使用青色、品红、绿色、粗红色和粗黄色，请添加以下行:

nvm help (or -h or --help)，nvm ls，nvm ls-remote 和 nvm alias 通常会产生彩色输出。你可以使用 --no-colors 选项禁用颜色（或通过设置环境变量 TERM=dumb）:

要恢复路径，你可以停用它:

要设置要在任何新 shell 中使用的默认节点版本，请使用别名“default”:

要使用节点二进制文件的镜像，请设置 $NVMNODEJSORG_MIRROR:

要使用 io.js 二进制文件的镜像，请设置 $NVMIOJSORG_MIRROR:

nvm use 默认情况下不会创建“当前”符号链接。将 $NVMSYMLINKCURRENT 设置为“true”以启用此行为，这有时对 IDE 很有用。请注意，在启用此环境变量的多个 shell 选项卡中使用 nvm 可能会导致竞争条件。

你可以在项目根目录（或任何父目录）中创建一个 .nvmrc 文件，其中包含节点版本号（或 nvm 理解的任何其他字符串；有关详细信息，请参见 nvm --help）。之后，nvm use、nvm install、nvm exec、nvm run 和 nvm which 如果命令行上没有提供版本，则将使用 .nvmrc 文件中指定的版本。

例如，要使 nvm 默认为最新的 5.9 版本、最新的 LTS 版本或当前目录的最新节点版本:

[注意:这些示例假定了 echo 的 POSIX 兼容 shell 版本。如果你使用 Windowscmd 开发环境，例如 .nvmrc 文件被用来配置远程 Linux 部署，那么请记住 "s 将被复制，从而导致一个无效的文件。删除它们。]

然后当你运行 nvm 时:

nvm useET。将从当前目录向上遍历目录结构，查找 .nvmrc 文件。换句话说，运行 nvm useet。在带有 .nvmrc 的目录的任意子目录中，都将使用 .nvmrc。

.nvmrc 文件的内容必须是 （如 nvm --help 所描述），后面跟着一个换行符。不允许有尾随空格，并且需要尾随换行符。

你可以使用 avn’](https://github.com/wbyoung/avn) 深入集成到你的 shell 中，并在更改目录时自动调用 nvm。avn不受nvm维护者的支持。请 [report issues to theavn` team。

如果你更喜欢重量较轻的解决方案，下面的方案是由 nvm 用户贡献的。它们不受 nvm 维护者的支持。然而，我们正在接受提供更多例子的请求。

将以下内容放在 $HOME/.bashrc 的末尾:

这个别名将从你当前的目录中搜索“up”，以检测 .nvmrc 文件。如果它找到它，它将切换到该版本；如果没有，它将使用默认版本。

将此放入 $HOME/.zshrc，以便每当你输入一个包含 .nvmrc 文件的目录时，自动调用 nvm use，该目录中的字符串告诉 nvm use 的哪个节点:

这需要安装 低音。

考试是用Urchin写的。安装 Urchin（和其他依赖项），如下所示:

有慢的测试和快的测试。缓慢的测试会执行安装节点和检查是否使用了正确的版本之类的操作。快速测试通过伪造这个来测试诸如别名和卸载之类的东西。从 nvm git库的根，运行这样的快速测试:

像这样运行慢速测试:

像这样运行所有测试:

Nota Bene:在测试运行时避免运行 nvm 。

nvm 公开以下环境变量:

此外， nvm 修改 PATH，并且，如果存在，则在更改版本时修改 MANPATH 和 NODE_PATH。

要激活，你需要获取 bash_completion:

在你的配置文件中，将上述sourcing line放在 nvm 的soucring line的下方。（bashrc,.bash_profile）。

nvm:

$ nvm 标签

nvm 别名:

$ nvm 别名 tab

$ nvm alias my_aliastab

nvm 用途:

$ nvm 使用 标签

nvm 卸载:

$ nvm 卸载 标签

如果你设置了一些非默认设置，nvm 将会遇到一些问题。（见 #606）已知造成问题的因素如下:

内部 ~/.npmrc:

环境变量:

外壳设置:

为了提供最佳性能（和其他优化）， nvm 将在运行 nvm install X 时为节点（和 NPM）下载并安装预编译的二进制文件。Node 项目编译、测试和托管 / 提供了这些为主流 / 传统 Linux 发行版（如 Debian、Ubuntu、CentOS、Redhat 等）构建的预编译二进制文件。

与主流 / 传统 Linux 发行版不同，Alpine Linux 基于 BusyBox ，这是一个非常紧凑（约 5MB）的 Linux 发行版。BusyBox（以及 Alpine Linux）对大多数主流 / 传统 Linux 发行版使用不同的 C/C++ 堆栈-穆尔。这使得为这种主流 / 传统的二进制程序与 Alpine Linux 不兼容，因此我们不能简单地在 Alpine Linux 上 nvm install X 并期望下载的二进制程序能够正确运行-如果你尝试这样做，你可能会看到“...不存在”错误。

对于 nvm install，有一个 -s 标志，它请求 nvm 下载节点源并在本地编译它。

如果在 Alpine Linux 上安装 nvm 仍然是你想要或需要做的事情，那么你应该能够通过运行以下 Alpine Linux shell 来实现这一点:

节点项目有一些愿望，但没有具体的计划（由于编译、测试和支持的管理费用）来提供与 Alpine 兼容的二进制文件。

作为一个潜在的替代方案，@mhart（一个节点贡献者）有一些 Docker images for Alpine Linux with Node and optionally, npm, pre-installed。

要手动删除 nvm，请执行以下操作:

编辑 ~/.bashrc（或其他壳资源配置）并删除以下行:

为了使开发和测试工作更容易，我们有一个用于开发的 DockerFile，它基于 Ubuntu18.04 基本映像，准备了用于 nvm 开发的必要和有用的工具，以构建环境的 docker 映像，运行位于 nvm库根的 docker 命令:

这将把你当前的 nvm 库与我们预先定义的开发环境打包成一个名为 nvm-dev 的 docker 映像，一旦构建成功，通过 docker images 验证你的映像:

如果没有错误消息，现在可以轻松地参与:

请注意，构建图像大约需要 8 分钟，图像大小大约为 650MB，因此不适合生产使用。

有关 docker 的更多信息和文档，请参阅其官方网站:

如果尝试安装节点版本，但安装失败，请确保运行 nvm cache clear 以删除缓存的节点下载，否则可能会出现以下错误:

curl: (33) HTTP server doesn't seem to support byte ranges. Cannot resume.

我的 sudo node 在哪里？查看 #43

在 V0.8.6 版本的 Node 之后， nvm 尝试从二进制软件包进行安装。但是在某些系统中，由于共享库的不兼容性，官方的二进制软件包无法工作。在这种情况下，使用 -s 选项强制从源代码安装:

nvm 在 Vim Shell 中找不到节点版本

如果你将节点版本设置为系统节点版本 nvm use 6.2.1 以外的版本，并打开 Vim 并运行 :!node -v，如果你看到系统版本 v6.2.1，你应该会看到 v0.12.7。你需要运行:

有关此问题的更多信息，请参见 Dotphiles/Dotzsh 。

nvm 与 NPM 配置不兼容的“前缀”选项

可以找到一些解决此问题的方法 这里

还有一个边缘情况导致了这个问题，那就是 $HOME 路径和用户的主目录的实际名称之间的不匹配。

你必须确保 $HOME 中的用户目录名和运行 ls /Users/ 时看到的用户目录名以相同的方式大写（[查看此问题]（https://github.com/ nvm -sh/ nvm /issues/2261））。

要更改用户目录和 / 或帐户名，请遵循以下说明 这里

homebrew 使 zsh 目录不安全

homebrew 会导致不安全的目录，比如 /usr/local/share/zsh/site-functions 和 /usr/local/share/zsh。这不是 nvm 问题，而是一个自制问题。有关此问题的一些解决方案，请参见 这里。

带有 M1 芯片的 Mac 电脑

在 Node.js v15.3 中添加了对 M1架构的实验性支持，并在 v16.0 中添加了完全支持。因此，如果你像往常一样尝试安装较旧版本的 Node，你可能会在安装 Node 时遇到编译错误，或者在运行代码时遇到内存不足错误。

因此，如果你希望在 M1Mac 上运行 V16.0 之前的版本，那么最好编译针对 x8664Intel 的节点架构，以便 Rosetta2 能够将 x8664 处理器的指令转换为基于 ARM 的 Apple Silicon 指令。以下是你需要做的:

如果你还没有安装 Rosetta，请安装它

你可能会想，“我的 M1Mac 怎么会知道在为英特尔芯片编译的 Node 版本中使用 Rosetta？". 如果一个可执行文件只包含英特尔指令，macOS 将自动使用 Rosetta 来翻译指令。

打开使用 Rosetta 运行的 shell

注意:同样的事情也可以通过在 Finder 中找到终端或 iTerm 应用程序，右键单击，选择“获取信息”，然后选中标有“使用 Rosetta 打开”的框来完成。

注意:这个终端会话现在在 zsh 中运行。 如果 zsh 不是你通常使用的 shell，则 nvm 可能不是 source。 如果是这种情况，请确保 sourcenvm。

安装你感兴趣的任何旧版本的节点。让我们以 12.2 2.1 为例。 这将获取节点源代码并对其进行编译，这将花费几分钟的时间。

注意:你可能很好奇为什么 --shared-zlib 会被包括在内。 苹果系统 clang 编译器的最新版本中存在一个错误。 如果在你的系统上安装了这些坏版本中的一个，那么即使你没有包含 --shared-zlib 标志，上述步骤仍然可能成功。 但是，稍后，当你尝试使用旧版本的 node.jsnpm install 时，你将看到 incorrect data check 错误。 如果你想避免处理此问题时可能出现的麻烦，那么请包含该标志。 有关更多详细信息，请参见 这个问题 和 此评论

退出回到你的本机 shell。

注意:如果你选择了标有“使用 Rosetta 打开”的框，而不是在第二步中运行 CLI 命令，那么你将在这里看到 i386。 除非你有其他理由选择该框，否则你现在可以取消对它的选择。

检查以确保架构是正确的。x64 是 x86_64 的缩写，这是你希望看到的。

现在，你应该可以像往常一样使用 Node 了。

目前，唯一的维护者是 @ljharb -更多的维护者是非常欢迎的，我们希望随着时间的推移，加入到团队中。治理 将随着项目的发展而重新评估。

见 license.md 。

版权 OpenJS 基金会 和 nvm 贡献者。版权所有。该 OpenJS 基金会 已注册商标并使用商标。有关 OpenJS 基金会 的商标列表，请参见我们的 商标政策 和 商标列表。Node.js 是 Joyent，Inc.的商标，并经其许可使用。OpenJS 基金会商标列表 上未注明的商标和标识是其各自持有者的商标或注册商标。使用它们并不意味着与它们有任何联系或得到它们的认可。

OpenJS 基金会 | 使用条款 | 隐私政策 | OpenJS 基金会章程 | 商标政策 | 商标列表 | cookie 政策