NVM安装速通使用手册（Windows版）NVM管理node版本命令手册 NVM使用手册
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 |