Windows 下使用 nvm 管理 Node.js 多版本 —— 完整指南

Node.js 版本更新频繁，不同项目可能依赖不同的版本，手动切换极为麻烦。nvm-windows 是专为 Windows 用户开发的 Node.js 多版本管理工具，可以轻松地安装、切换、卸载 Node.js 版本。

本篇将从下载到实际使用，手把手带你玩转 nvm-windows。

---

一、下载 nvm-windows 安装包

进入 GitHub 项目地址：nvm-windows Releases

下载最新版的 nvm-setup.zip 安装包或 .exe 安装器，建议直接使用 .exe 安装版本，简单快捷。

---

二、安装 nvm-windows

1. 双击安装程序开始安装。
2. 选择 nvm 安装路径。
3. 选择 Node.js 安装路径。

注意：**不要使用带空格的路径！**如 C:\Program Files 这种路径可能引起后续问题。

安装完成后，打开 PowerShell 或命令行窗口，输入：

nvm version

若成功输出版本号，如：

1.2.2

说明安装成功 ✅

---

三、常用 nvm-windows 命令速查

命令	说明
nvm install	安装指定版本 Node.js
nvm install [arch]	指定架构安装（32/64位）
nvm list / nvm ls	列出已安装版本
nvm list available	查看可安装的所有版本
nvm use	切换使用某个版本
nvm uninstall	卸载某个版本
nvm root [path]	设置或查看 nvm 根目录
nvm proxy [url]	设置代理
nvm node_mirror [url]	设置 Node.js 镜像源
nvm npm_mirror [url]	设置 npm 镜像源
nvm arch	显示当前架构（32/64）

---

四、安装与切换 Node.js 版本示例

安装某个版本，推荐安装LTS版本（如 22.17.0）

nvm install 22.17.0

安装成功后：

nvm use 22.17.0

切换成功后，可验证当前版本：

node -v

输出：

v22.17.0

说明已切换成功 ✅

安装最新版本（如最新稳定版）

nvm install latest

---

五、升级 Node.js 版本建议流程

1. 安装最新版本：

   nvm install 22.17.0
   

2. 切换新版本：

   nvm use 22.17.0
   

3. 如需全局 npm 包迁移，可使用以下命令备份/恢复：

   npm list -g --depth=0 > global-packages.txt
   

   然后在新版本中重新安装：

   cat global-packages.txt | xargs npm install -g
   

---

六、可能遇到的问题与解决

问题	解决方案
nvm use 后 node -v 依然是旧版本	检查环境变量是否配置冲突，删除旧 Node.js 的 PATH 路径
安装失败	检查网络问题或切换镜像源为淘宝
权限问题	使用管理员权限运行 PowerShell 再试

---

七、参考资料

• nvm-windows GitHub 项目
• 阿里 npm 镜像站
• Node.js 官方下载地址

---

总结

nvm-windows 是 Windows 开发者管理 Node.js 版本的利器，安装简单、切换灵活，适合日常开发使用。合理配置镜像源，还能大大提升下载速度，推荐每位前端工程师都掌握这项技能。

如果你还在手动切换 Node.js 版本，是时候换上 nvm 了！