NVM (Node Version Manager) 使用指南
NVM 是 Node.js 版本管理工具，允许在同一台机器上安装和切换多个 Node.js 版本。
🚀 安装与设置
安装 NVM
# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 或者使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
配置环境变量
# 添加到 ~/.bashrc 或 ~/.zshrc
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
验证安装
nvm --version
📦 Node.js 版本管理
查看可用版本
nvm list-remote # 查看所有可安装版本
nvm list-remote --lts # 只查看 LTS 版本
安装 Node.js
nvm install <版本号> # 安装指定版本
nvm install --lts # 安装最新的 LTS 版本
nvm install node # 安装最新的稳定版本
nvm install 18 # 安装 18.x 最新版本
nvm install 18.17.0 # 安装精确版本
切换版本
nvm use <版本号> # 切换到指定版本
nvm use --lts # 切换到最新的 LTS 版本
nvm use node # 切换到最新的稳定版本
查看本地版本
nvm list # 查看已安装版本
nvm current # 查看当前使用的版本
nvm ls # 简写形式
设置默认版本
nvm alias default <版本号> # 设置默认版本
nvm alias default lts/* # 设置 LTS 为默认
🗑️ 版本管理
卸载版本
nvm uninstall <版本号> # 卸载指定版本
设置别名
nvm alias <别名> <版本号> # 为版本设置别名
nvm alias project1 18.17.0 # 例如
nvm use project1 # 使用别名
🔧 高级功能
在项目中使用
# 在项目根目录创建 .nvmrc 文件
echo "18.17.0" > .nvmrc
# 使用项目指定的版本
nvm use
# 自动切换版本（需要配置）
nvm use --silent-if-unchanged
运行特定版本
nvm run <版本号> <命令> # 使用指定版本运行命令
nvm run 18 npm install # 使用 Node 18 运行 npm install
nvm exec <版本号> <命令> # 另一种方式
查看版本信息
nvm version <版本号> # 查看版本详细信息
nvm which <版本号> # 查看版本安装路径
💡 常用场景
项目开发
# 1. 为不同项目设置不同版本
cd project-a
echo "16.20.0" > .nvmrc
cd ../project-b
echo "18.17.0" > .nvmrc
# 2. 在项目目录自动切换
nvm use # 会自动读取 .nvmrc
升级 Node.js
# 查看并安装最新版本
nvm list-remote | tail -1
nvm install <最新版本>
nvm use <最新版本>
nvm alias default <最新版本>
清理空间
# 查看占用空间
du -sh ~/.nvm/versions/node/
# 卸载不需要的版本
nvm uninstall 14.15.0
nvm uninstall 15.0.0
🔍 故障排除
NVM 命令找不到
# 重新加载配置
source ~/.bashrc
source ~/.zshrc
# 或者重启终端
Node/npm 版本不匹配
# 重新安装 Node.js
nvm reinstall-packages <版本号>
📝 文档信息
- 作者: 阿鑫
- 更新日期: 2026.4
