NVM (Node Version Manager) 使用指南

NVM (Node Version Manager) 使用指南

NVM 是一个用于管理多个 Node.js 版本的工具，它允许你在同一台计算机上安装和切换不同版本的 Node.js。

基本命令

查看可用的 Node.js 版本

nvm ls-remote

安装特定版本的 Node.js

nvm install 16.14.0  # 安装指定版本
nvm install --lts    # 安装最新的 LTS 版本
nvm install node     # 安装最新版本

查看已安装的 Node.js 版本

nvm ls

切换 Node.js 版本

nvm use 16.14.0      # 切换到指定版本
nvm use --lts        # 切换到已安装的最新 LTS 版本
nvm use node         # 切换到最新版本

设置默认 Node.js 版本

nvm alias default 16.14.0  # 设置默认版本
nvm alias default lts/*    # 设置默认为最新 LTS 版本

运行特定版本的 Node.js

nvm run 16.14.0 app.js

在当前终端窗口中使用特定版本的 Node.js

nvm exec 16.14.0 node app.js

查找特定版本的 Node.js 安装路径

nvm which 16.14.0

项目特定版本配置

在项目根目录创建 .nvmrc 文件，内容为需要的 Node.js 版本号：

16.14.0

然后在项目目录中运行：

nvm use

NVM 将自动切换到 .nvmrc 文件中指定的版本。

常见问题解决

1. 安装后无法使用 nvm 命令

确保已将 NVM 的初始化脚本添加到你的 shell 配置文件中（~/.bash_profile, ~/.zshrc, ~/.profile, 或 ~/.bashrc）：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载 nvm bash_completion

2. 切换版本后 Node 命令不可用

尝试重新打开终端或运行 source ~/.zshrc（或你使用的 shell 配置文件）。

3. 全局安装的包在切换版本后不可用

每个 Node.js 版本都有自己的全局包。切换版本后，需要重新安装全局包：

nvm use 16.14.0
npm install -g <package-name>

高级用法

使用别名

nvm alias my-node 16.14.0  # 创建别名
nvm use my-node            # 使用别名
nvm unalias my-node        # 删除别名

在新的 shell 中自动使用特定版本

nvm use 16.14.0 --silent

安装时自动使用

nvm install 16.14.0 --reinstall-packages-from=current

迁移全局包

nvm install 18.12.0 --reinstall-packages-from=16.14.0