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
- 双击安装程序开始安装。
- 选择 nvm 安装路径。
- 选择 Node.js 安装路径。
📌 注意：**不要使用带空格的路径！**如
C:\Program Files这种路径可能引起后续问题。
安装完成后，打开 PowerShell 或命令行窗口，输入：
nvm version
若成功输出版本号，如：
1.2.2
说明安装成功 ✅
三、常用 nvm-windows 命令速查
| 命令 | 说明 |
|---|---|
nvm install <version> | 安装指定版本 Node.js |
nvm install <version> [arch] | 指定架构安装（32/64位） |
nvm list / nvm ls | 列出已安装版本 |
nvm list available | 查看可安装的所有版本 |
nvm use <version> | 切换使用某个版本 |
nvm uninstall <version> | 卸载某个版本 |
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 版本建议流程
-
安装最新版本：
nvm install 22.17.0 -
切换新版本：
nvm use 22.17.0 -
如需全局 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 了！