一、准备工作：卸载旧版 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.0
2. 管理已安装版本
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:port
2. 权限问题
错误提示：Access is denied
解决方法：以管理员身份运行终端
3. 环境变量未生效
处理方式：重启终端或执行：
refreshenv
4. 多版本共存
通过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]
