使用 nvm 管理多版本 Node 项目依赖

nvm 是 Node.js 的版本管理器 (version manager)，可在同一台主机上安裝多个版本的 Node.js 环境，因为不同项目可能使用不同的 Node.js 版本，那就需要通过一个版本管理器来切换不同的 Node.js 版本

nvm-sh/nvm - Github 仓库地址

安装/升级 NVM

脚本安装

可用 cURL 或 wget 指令使用安裝脚本安裝或更新 nvm (更新的时候重新运行下脚本即可)：

bash 复制代码

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

此安装脚本会把 nvm repo clone 到 ~/.nvm，并将 source line 新增至你的 profile 设定 ( ~/.bash_profile、~/.zshrc、~/.profile 或 ~/.bashrc )

brew 安装

可以使用 brew 安装 nvm

复制代码

brew install nvm

安装完毕之后检查是否存在如下 source line, 没有可以手动添加到 .zshrc

bash 复制代码

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

如果在 Linux 执行安装脚本后，执行下面指令会显示以下信息或没有任何信息时候，建议重新打开终端 (terminal) 再重新执行一次 nvm 指令：

bash 复制代码

$ command -v nvm
nvm: command not found

如果还是无法使用 nvm，可执行下面指令立即应用 ZSH 的设定：

bash 复制代码

source .zshrc

注意：

使用 nvm 時，不需要 sudo 即可使用 npm -g 全局命令, 使用 sudo 会导致不可预料的权限错误
若你有 ~/.npmrc，请确保里面不包含任何 prefix 的设定 (因为和 nvm 不相容)
你可以 (但不应该) 保留以前在 系统 安裝的 Node.js，但 nvm 只对你的当前账号可用。可能会导致版本不 match，因为其他使用者会使用 /usr/local/lib/node_modules/*，而当前账户会使用 ~/.nvm/versions/node/vX.X.X/lib/node_modules/*

命令

`--version`

确认 NVM 是否安裝成功

css 复制代码

$ nvm --version
0.40.4

`install`

利用 NVM 安装 Node.js

安裝 NVM 后，其实还没安装 Node 环境：

bash 复制代码

$ node
zsh: command not found: node

如果执行下面指令，会提醒你需要执行 install 指令才能安裝 Node.js：

vbnet 复制代码

$ nvm use node
N/A: version "node -> N/A" is not yet installed.
You need to run "nvm install node" to install it before using it.

安裝最新版的 Node.js：

bash 复制代码

$ nvm install node
Downloading and installing node v25.8.0...
Downloading https://nodejs.org/dist/v25.8.0/node-v25.8.0-darwin-arm64.tar.xz...
################################################################################################################################################ 100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v25.8.0 (npm v11.11.0)

如果要指定安裝版本，可以直接指定版本號：

ruby 复制代码

$ nvm install 24

安装的第一个版本的 Node.js 会成为 nvm 的默认版本，新的 shell 就会以默认版本的 Node.js 来使用 (例如：nvm alias default)。查看目前安裝 Node.js 的版本：

ruby 复制代码

$ node -v
v25.8.0

`ls-remote`

察看可用的安装版本

可以看目前有哪些可用版本可安装，在版本号前面的 -> 箭头符号代表目前 nvm 正在使用的 Node.js 版本：

less 复制代码

$ nvm ls-remote
...
       v24.11.0   (LTS: Krypton)
       v24.11.1   (LTS: Krypton)
       v24.12.0   (LTS: Krypton)
       v24.13.0   (LTS: Krypton)
       v24.13.1   (LTS: Krypton)
       v24.14.0   (Latest LTS: Krypton)
...
        v25.7.0
->      v25.8.0

不过刚才的 ls-remote 指令会把所有可用的版本都列出来，但通常会选择安装 LTS（Long-term support，长期支援）版，所以只要加上 -lts 参数就可以只列出可用的 LTS 版：

scss 复制代码

$ nvm ls-remote --lts
...
       v22.22.1   (Latest LTS: Jod)
       v24.11.0   (LTS: Krypton)
       v24.14.0   (Latest LTS: Krypton)

如果版本号的文字有特殊颜色（不是白色字），则代表该版本的Node.js有通过nvm安装过

`ls`

查看目前安装了哪些版本

ls 指令可以查看目前安装了哪些版本：

bash 复制代码

$ nvm ls
       v16.20.2
       v22.21.0
       v24.11.1
->      v25.8.0
default -> 24 (-> v24.11.1 *)
iojs -> N/A (default)
node -> stable (-> v25.8.0 *) (default)
stable -> 25.8 (-> v25.8.0 *) (default)
unstable -> N/A (default)
lts/* -> lts/krypton (-> N/A)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.17.0 (-> N/A)
lts/dubnium -> v10.24.1 (-> N/A)
lts/erbium -> v12.22.12 (-> N/A)
lts/fermium -> v14.21.3 (-> N/A)
lts/gallium -> v16.20.2 *
lts/hydrogen -> v18.20.8 (-> N/A)
lts/iron -> v20.20.1 (-> N/A)
lts/jod -> v22.22.1 (-> N/A)
lts/krypton -> v24.14.0 (-> N/A)

`use`

切换 Node.js 版本

如果要使用 nvm 切换正在使用的 Node.js 版本，可用 use 指令：

arduino 复制代码

$ nvm use v24.11.1
Now using node v24.11.1 (npm v11.6.2)

如果切换的目标版本还没安装，nvm 会提醒你要安装：

perl 复制代码

$ nvm use lts/krypton
N/A: version "lts/krypton -> v24.14.0" is not yet installed.

You need to run `nvm install lts/krypton` to install and use it.

通过 nvm 安装 Node.js 時，nvm 会将不同的 Node.js 版本儲存在 ~/.nvm/versions/node/vX.X.X，然后再修改 $PATH，将指定版本的 Node.js 路径加入：在 nvm 的各个 Node.js 版本安装的全部程序都会在各自版本的目录内安装，所以在切换至新安装的 Node.js 版本后需要重新安装，也因为如此，不同版本间的程序不会有兼容问题。

`current`

察看目前使用版本

如果忘記自己切换到哪个版本，可以用 current 指令：

ruby 复制代码

$ nvm current
v24.11.1

`run`

直接执行 Node.js

如果要直接执行Node.js，可以使用下面指令：

erlang 复制代码

$ nvm run node
Running node v25.8.0 (npm v11.11.0)
Welcome to Node.js v25.8.0.
Type ".help" for more information.
>

`exec`

指定要执行的 Node.js 版本

python 复制代码

$ nvm exec 25.8.0 node
Running node v25.8.0 (npm v11.11.0)
Welcome to Node.js v25.8.0.
Type ".help" for more information.
>

`which`

察看 Node.js 的安装路径

执行下面指令可以查看特定版本的 Node.js 的安装路径：

bash 复制代码

$ nvm which 25.8.0
/Users/duoli/.nvm/versions/node/v25.8.0/bin/node

`alias`

察看別名、设定別名

如下图有些版本的文字是紅色或是显示 N/A，就代表该版本未在电脑安装：

默认别名可以取代版本号：

node：安装最新版的 Node.js
iojs：安装最新版的 io.js
stable：此 alias 已弃用，僅適用於 v0.12 以及更舊版，目前改為 node alias
unstable：此 alias 為 v0.11，最后一個 "unstable" (不穩定) Node release，在 v1.0 之后的版本都是稳定版 (in SemVer, versions communicate breakage, not stability)

可在下面这些指令使用以上预设別名：

nvm install
nvm use
nvm run
nvm exec
nvm which
... 等

察看別名

bash 复制代码

$ nvm ls
->     v16.20.2
       v18.18.0
default -> 16 (-> v16.20.2)
iojs -> N/A (default)
unstable -> N/A (default)
node -> stable (-> v18.18.0) (default)
stable -> 18.18 (-> v18.18.0) (default)
lts/* -> lts/hydrogen (-> v18.18.0)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.17.0 (-> N/A)
lts/dubnium -> v10.24.1 (-> N/A)
lts/erbium -> v12.22.12 (-> N/A)
lts/fermium -> v14.21.3 (-> N/A)
lts/gallium -> v16.20.2
lts/hydrogen -> v18.18.0

设定別名

ruby 复制代码

$ nvm alias titan-test v10.15.3                                                  * ?
titan-test -> v10.15.3

接著用 nvm alias 指令就會看到刚刚新增的別名所对应的 Node.js 版本：SHELL

rust 复制代码

$ nvm alias                                                                    * ?
titan-test -> v10.15.3
default -> v10.16.3
node -> stable (-> v12.8.1) (default)
stable -> 12.8 (-> v12.8.1) (default)
iojs -> N/A (default)
unstable -> N/A (default)
lts/* -> lts/erbium (-> N/A)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.16.2 (-> N/A)
lts/dubnium -> v10.17.0 (-> N/A)
lts/erbium -> v12.13.0 (-> N/A)

FAQ

卸载 Nvm

基本上，需要反向执行 install.sh中的步骤-从 ~/.bash_profile(和/或 ~/.profile) 中删除所有 nvm 注册，然后重新打shell 如果是 nvm 失效, 只需从 .bash_profile 或 .profile 中删除NVM命令就足够, 如果你有其他的 node 执行环境, 则也需要删除, 则需要执行如下命令

shell 复制代码

$ rm -rf ~/.nvm

Jenkins 中应用

在 Jenkins 中应用需要执行如下命令

javascript 复制代码

. ~/.nvm/nvm.sh

更新记录

2026年03月10日

更新贴图 / 验证命令输出情况

2025年11月05日

更新最新的版本号
更新处理结构

2023-11-02

增加国内源的访问