3、Windows安装NVM:从下载到验证
Windows 上装 NVM,其实比 Mac 要简单不少。我最早在 Windows 上折腾 Node 版本时,用的还是手动替换环境变量那种笨办法,后来发现 nvm-windows 这个工具,简直像发现了新大陆。今天咱们就把安装流程走一遍,每一步我都会把坑点指出来。
核心要点:nvm-windows 不是 Linux/Mac 版 NVM 的移植,而是独立开发的 Windows 原生工具。安装前务必卸载已存在的 Node.js,否则版本管理会乱套。
3.1 下载安装包:选对版本很重要
去 GitHub 搜 nvm-windows,找到 coreybutler/nvm-windows 这个仓库。进 Releases 页面,你会看到几个文件:
| 文件名 | 说明 | 我推荐 |
|---|---|---|
nvm-setup.exe |
安装向导版,带图形界面 | ✅ 首选 |
nvm-noinstall.zip |
绿色版,解压即用 | ❌ 不推荐新手用 |
nvm-update.exe |
升级工具 | 安装后备用 |
我个人习惯直接下载 nvm-setup.exe。为什么?因为安装向导会帮你处理环境变量和路径配置,省心。绿色版虽然看起来轻量,但手动配环境变量容易出错,我见过好几个同事在这上面翻车。
小提示:下载前看一眼版本号。建议选最新的稳定版,比如 v1.1.12 或更高。太老的版本对 Node 18+ 的支持可能有问题。
3.2 安装向导详解:每一步都有讲究
双击 nvm-setup.exe,安装过程分三步。我带你一步步走,顺便说说每步的坑。
第一步:同意协议
没啥好说的,点 I accept 继续。
第二步:选择 NVM 安装路径
这里要注意了。默认路径是 C:\Users\你的用户名\AppData\Roaming\nvm。我个人建议改到 C:\nvm 或 D:\nvm。为什么?
- 路径里不要有中文和空格,否则后面装 Node 时会报路径解析错误
- 放在盘符根目录,方便后续维护和备份
- 避免用户目录权限问题——我曾经遇到过 Windows 更新后用户目录权限重置,NVM 直接罢工
⚠️ 避坑指南:安装路径一旦确定,后期不要手动移动文件夹。NVM 的环境变量写死了路径,移动后所有命令都会失效。我曾经手贱挪过一次,折腾了半小时才恢复。
第三步:选择 Node.js 符号链接路径
这一步很多人会忽略。安装向导会问 Node.js Symlink 路径,默认是 C:\Program Files\nodejs。这个路径是 NVM 用来创建软链接的,切换 Node 版本时,NVM 会修改这个链接指向。
我建议保持默认,或者改成 C:\nodejs。注意:这个路径也不能有中文和空格。
第四步:确认安装
点 Install,等进度条走完。安装完成后,桌面不会有快捷方式,别慌——NVM 是命令行工具。
3.3 验证安装是否成功
安装完别急着用,先验证一下。打开一个新的 命令提示符(cmd) 或 PowerShell,注意:一定要新开窗口,因为环境变量只在新的进程里生效。
输入以下命令:
nvm version
如果看到类似 1.1.12 的版本号,说明安装成功。如果提示 'nvm' 不是内部或外部命令,别慌,检查以下几点:
- 是否新开了命令行窗口? 旧窗口不会加载新环境变量
- 环境变量是否配置正确? 打开系统环境变量,检查
NVM_HOME和NVM_SYMLINK是否指向了正确的路径 - PATH 里是否添加了 %NVM_HOME%? 安装向导一般会自动加,但偶尔会遗漏
快速验证清单:
nvm version→ 显示版本号 ✅nvm list→ 显示空列表(还没装 Node) ✅where nvm→ 显示 nvm.exe 所在路径 ✅
3.4 安装后的目录结构
安装完成后,看看 NVM 目录里都有什么。以 C:\nvm 为例:
C:\nvm
├── nodejs # 符号链接目录(初始为空)
├── v16.20.2 # 安装 Node 16 后会出现
├── v18.19.0 # 安装 Node 18 后会出现
├── elevate.cmd
├── elevate.vbs
├── install.cmd
├── nvm.exe
└── settings.txt # 配置文件
这个 settings.txt 很重要,里面记录了 NVM 的配置。你可以用记事本打开看看:
root: C:\nvm
path: C:\Program Files\nodejs
arch: 64
proxy: none
如果以后想改 Node 安装镜像源(比如用淘宝镜像),就是在这里加一行 node_mirror: https://npmmirror.com/mirrors/node/。这个咱们后面章节会细讲。
3.5 常见安装问题与解决
| 问题 | 原因 | 解决方法 |
|---|---|---|
'nvm' 不是内部命令 |
环境变量未生效或未配置 | 重新打开命令行;检查 NVM_HOME 和 PATH |
| 安装过程中报权限错误 | 没有以管理员身份运行 | 右键安装包 → 以管理员身份运行 |
| 安装后无法创建符号链接 | Windows 开发者模式未开启 | 设置 → 更新和安全 → 开发者选项 → 开启开发人员模式 |
| 安装路径包含中文 | NVM 解析路径时乱码 | 卸载重装,路径改为纯英文 |
⚠️ 重要提醒:如果你之前装过 Node.js,一定要先卸载干净。包括:
- 控制面板卸载 Node.js
- 删除
C:\Program Files\nodejs残留文件夹 - 清理环境变量中的 Node.js 路径
否则 NVM 创建的符号链接会和旧 Node 冲突,导致版本切换失败。
3.6 本章知识结构图
下面这张图帮你理清整个安装流程和关键节点:
3.7 小结
Windows 安装 NVM 其实就三步:下载、安装、验证。但每一步都有细节要注意。我个人觉得,最关键的还是两点:
- 安装路径纯英文——这个坑我踩过,后来每次给别人装都反复提醒
- 先卸载旧 Node——否则 NVM 的符号链接机制会失效