nvm（Node Version Manager）是一个用于管理Node.js版本的命令行工具。通过nvm，你可以在同一台机器上安装和切换多个Node.js版本，非常适合开发和测试在不同Node.js版本上运行的应用程序

---

一、安装地址

1. 官方下载： （推荐选择nvm-setup.exe安装包，避免绿色版路径问题）

下载地址：GitHub nvm-windows最新版

2. 站内下载

下载地址: nvm-setup-1.2.2

---

二、安装步骤

1. 必须！！！卸载旧版Node.js

• 控制面板 → 卸载Node.js (打开控制面板方法)
• 手动删除残留：C:\Program Files\nodejs、用户目录下的.npmrc及AppData\Roaming\npm等文件夹
  • C:\Program Files (x86)\Nodejs
  • C:\Program Files\Nodejs
  • C:\Users\用户名\AppData\Roaming\npm
  • C:\Users\用户名\AppData\Roaming\npm-cache

2. 安装NVM

• 安装路径：纯英文、无空格（例如D:\nvm）
• Node.js路径：建议与NVM同级目录（例如D:\nvm\nodejs）

3. 验证安装

nvm -v # 显示版本号即成功

三、配置镜像源（加速下载）

1. 设置淘宝镜像源

npm config set registry https://registry.npmmirror.com

原域名https://registry.npm.taobao.org/ 在 2022.06.30 号正式下线和停止 DNS 解析

2. 查看镜像使用状态

npm config get registry

设置成功如下

---

四、核心使用命令

命令	功能描述	备注
nvm list available	查看可安装版本
nvm install 18.16.0	安装指定版本
nvm use 18.16.0	切换版本
nvm ls	查看已安装版本（带*为当前）
nvm uninstall 14.17.0	卸载版本
nvm install --lts	安装最新LTS（稳定版）
npm config set registry …	设置npm镜像（中国用户必选）	https://registry.npmmirror.com

---

五、常见问题

1. 切换版本后命令失效

• 管理员权限运行CMD
• 检查路径是否含中文/空格

2. 镜像源报错

• 确认镜像地址是否为https://registry.npmmirror.com新域名

3. NVM无法识别Node

• 彻底卸载旧版Node环境变量

---

六、环境变量配置（自动完成）

NVM安装后默认自动配置系统变量，无需手动操作。若需自定义全局模块路径：

npm config set prefix "D:\nvm\node_global"
npm config set cache "D:\nvm\node_cache"

（路径需与NVM目录一致）

---

效率提示：使用nvm use前，建议通过nvm list确认版本状态，避免路径冲突。

附录：NVM 常用命令表详细版

命令	描述	示例
nvm install <版本号>	安装指定版本的Node.js	nvm install 16.14.0
nvm install --lts	安装最新的LTS（长期支持）版本	nvm install --lts
nvm use <版本号>	切换到指定版本的Node.js	nvm use 16.14.0
nvm ls	列出所有已安装的Node.js版本	nvm ls
nvm ls-remote	列出所有可安装的Node.js版本	nvm ls-remote
nvm ls-remote --lts	列出所有可安装的LTS版本	nvm ls-remote --lts
nvm uninstall <版本号>	卸载指定版本的Node.js	nvm uninstall 14.17.0
nvm current	显示当前使用的Node.js版本	nvm current
nvm alias <别名> <版本号>	为指定版本设置别名	nvm alias default 16.14.0
nvm unalias <别名>	删除指定的别名	nvm unalias default
nvm reinstall-packages <版本>	将全局npm包从一个版本重新安装到另一个版本	nvm reinstall-packages 14.17.0
nvm on	启用nvm	nvm on
nvm off	禁用nvm	nvm off
nvm version	显示nvm的版本号	nvm version
nvm cache dir	显示nvm的缓存目录	nvm cache dir
nvm cache clear	清除nvm的缓存	nvm cache clear
nvm exec <版本号> <命令>	在指定版本的Node.js中运行命令	nvm exec 16.14.0 node -v
nvm run <版本号> <脚本>	使用指定版本的Node.js运行脚本	nvm run 16.14.0 app.js
nvm which <版本号>	显示指定版本的Node.js可执行文件路径	nvm which 16.14.0