一、准备工作:卸载旧版 Node.js
重要提示:在安装 NVM 前,请先彻底删除已安装的 Node.js,避免路径冲突:
检查安装路径
where node常见路径:
C:\Program Files\nodejs\ C:\Users\用户名\AppData\Local\nodejs\卸载步骤:
通过控制面板卸载 Node.js 程序
删除上述路径下的所有文件
清理环境变量:
右键此电脑 → 属性 → 高级系统设置 → 环境变量
删除所有包含nodejs的系统变量和用户变量
为什么需要这样做?
NVM 通过自定义路径管理 Node 版本,若旧版 Node 存在:
可能导致where node返回错误路径
环境变量优先级冲突
版本管理混乱
二、NVM 安装与验证详解
1. 下载 NVM
访问官方GitHub仓库:
https://github.com/coreybutler/nvm-windows/releases
选择带有nvm-setup的最新.msi 文件(如nvm-setup_1.1.17.msi)
2. 安装过程
运行安装程序时:
建议保持默认安装路径C:\Program Files\nvm\
确保勾选 "Add to environment variables"
安装完成后需重启终端生效
3. 验证安装
where node✅ 正常输出:
C:\Program Files\nvm\v20.18.0\node.exe❌ 异常情况处理:
若未找到路径:重新检查环境变量
若显示旧版路径:彻底删除旧版 Node.js
原理:
Windows 的where命令会搜索系统 PATH 环境变量中的所有目录。NVM 安装时会将自身路径添加到 PATH 最前端,因此正常情况下应优先找到 NVM 管理的 Node.js 可执行文件。
4. 检查 NVM 版本
nvm version输出示例:
1.1.17三、版本管理深度解析
1. 查看可用版本
nvm list-remote输出说明:
14.21.3 LTS (LTS: Erbium) 18.18.2 LTS (LTS: Hydrogen) -> 20.18.0 Current (Latest LTS: Iron)箭头标记表示当前最新 LTS 版本
LTS 版适合生产环境(长期支持)
Current 版包含最新特性(可能不稳定)
2. 安装指定版本
nvm install 20.18.0🔍 执行过程:
检查本地缓存是否存在该版本
从 Node.js 官网下载对应版本
解压到C:\Program Files\nvm\v20.18.0目录
3. 切换使用版本
nvm use 20.18.0🔄 切换原理:
修改nvm目录下的settings.txt
建立current软链接指向目标版本
自动更新系统临时环境变量
四、最终验证与维护
1. 检查 Node.js/npm 版本
node -v npm -v✅ 预期输出:
v20.18.0 10.2.02. 管理已安装版本
nvm list输出示例:
18.18.2 * 20.18.0 (Currently using 64-bit executable)3. 常用维护命令
nvm uninstall 18.18.0 # 删除指定版本 nvm arch 64 # 切换64/32位版本 nvm proxy # 设置下载代理五、常见问题解决方案
1. 网络下载失败
错误提示:Request failed with status code 443
解决方案:
nvm proxy http://your-proxy:port2. 权限问题
错误提示:Access is denied
解决方法:以管理员身份运行终端
3. 环境变量未生效
处理方式:重启终端或执行:
refreshenv4. 多版本共存
通过nvm use切换版本
项目级管理建议使用.nvmrc文件:
echo "20.18.0" > .nvmrc nvm use验证逻辑总结
A[执行where node] --> B{输出NVM路径?}
B -->|是| C[验证成功] B -->|否| D[检查旧版Node.js残留] E[执行nvm version] --> F{显示版本号?} F -->|是| G[版本验证通过] F -->|否| H[修复环境变量] I[执行node -v] --> J{版本正确?} J -->|是| K[完整验证通过] J -->|否| L[重新执行nvm use]