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 命令速查

四、安装与切换 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-windows GitHub 项目
• 阿里 npm 镜像站
• Node.js 官方下载地址

总结

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

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