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' 不是内部或外部命令,别慌,检查以下几点:

  1. 是否新开了命令行窗口? 旧窗口不会加载新环境变量
  2. 环境变量是否配置正确? 打开系统环境变量,检查 NVM_HOME 和 NVM_SYMLINK 是否指向了正确的路径
  3. 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 本章知识结构图

下面这张图帮你理清整个安装流程和关键节点:

Windows安装NVM流程结构图 Windows 安装 NVM 核心流程 ① 下载安装包 ② 安装向导 ③ 验证安装 下载要点 • 选 nvm-setup.exe • 选最新稳定版 • 先卸载旧 Node.js 安装向导四步走 1. 同意协议 2. 选择 NVM 路径(纯英文) 3. 选择 Node 符号链接路径 4. 确认安装 验证命令 • nvm version • nvm list • where nvm 关键决策:路径不能有中文和空格 ✅ 安装成功:可正常使用 nvm 命令 安装完成后,记得新开命令行窗口再验证

3.7 小结

Windows 安装 NVM 其实就三步:下载、安装、验证。但每一步都有细节要注意。我个人觉得,最关键的还是两点:

  • 安装路径纯英文——这个坑我踩过,后来每次给别人装都反复提醒
  • 先卸载旧 Node——否则 NVM 的符号链接机制会失效