Windows 环境下 NVM 安装与 Node.js 版本管理完全指南

💡 为什么需要 NVM？

作为前端开发者，你是否遇到过这些困扰：

NVM（Node Version Manager）就是为解决这些问题而生的版本管理神器！

🛠️ 准备工作：彻底清理旧环境

⚠️重要提醒：安装 NVM 前必须完全卸载系统中已有的 Node.js！

卸载步骤：

1. 程序卸载
   • 控制面板 → 程序和功能 → 找到 Node.js → 右键卸载

2. 清理残留文件（手动删除以下目录）：

   C:\Program Files\nodejs # 全局 Node 安装目录 C:\Users\<你的用户名>\AppData\Local\npm # npm 缓存 C:\Users\<你的用户名>\.npmrc # npm 配置文件

3. 清理环境变量：

   • 按Win + R输入sysdm.cpl
   • 高级 → 环境变量
   • 删除Path中所有包含nodejs或npm的条目

4. 验证清理结果：

   node-v# 应提示 "不是内部或外部命令"npm-v# 应提示 "不是内部或外部命令"

📥 下载与安装 NVM for Windows

下载地址：

🔗 NVM for Windows 官方 GitHub

选择安装包：

安装过程（以nvm-setup.exe为例）：

步骤1：双击运行安装程序，点击 Next

步骤2：接受许可协议，点击 Next

步骤3：选择 NVM 安装路径（建议默认）

📍 默认路径：C:\Users\<用户名>\AppData\Local\nvm

步骤4：设置 Node.js 符号链接路径

📍关键设置：建议设为C:\Program Files\nodejs
⚠️注意：路径不能包含中文和空格！

步骤5：一直 Next，等待安装完成

✅ 验证安装是否成功

打开管理员权限的命令提示符或 PowerShell：

# 查看 NVM 版本nvm version# 输出示例：1.1.12# 查看帮助信息nvmhelp

📌如果报错“‘nvm’ 不是内部或外部命令”：

1. 检查环境变量是否正确配置
2. 重启终端或电脑
3. 确认旧版 Node.js 已完全卸载

🚀 使用 NVM 管理 Node.js

1️⃣ 查看可安装版本

# 查看所有可用版本nvm list available# 输出示例：# | CURRENT | LTS | OLD STABLE | OLD UNSTABLE |# |--------------|--------------|--------------|--------------|# | 22.1.0 | 20.12.0 | 18.19.0 | 16.20.2 |

2️⃣ 安装指定版本

# 安装指定版本（推荐 LTS）nvminstall20.12.0# 安装最新 LTS 版本nvminstalllts# 安装最新开发版nvminstalllatest# 安装指定主版本的最新版nvminstall18# 会安装 18.x 系列最新版

3️⃣ 查看已安装版本

nvm list# 或简写nvmls# 输出示例：# * 20.12.0 (Currently using 64-bit executable)# 18.19.0# 16.20.2

📍 带*号的是当前正在使用的版本

4️⃣ 切换 Node.js 版本

# 切换到指定版本nvm use18.19.0# 切换到 LTS 版本nvm use lts# 验证切换结果node-v# 输出：v18.19.0npm-v# 输出：对应版本的 npm

⚠️注意：切换版本需要管理员权限！

📚 常用命令速查表

⚡ 进阶技巧

🎯 设置默认版本（持久生效）

# 设置默认版本，新终端自动使用nvmaliasdefault20.12.0# 验证设置nvmalias# 输出：default -> 20.12.0

🚄 配置国内镜像（加速下载）

方法：编辑 NVM 安装目录下的settings.txt文件：

node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/

📌效果：下载速度提升 10 倍以上！

📁 项目级版本管理（配合 .nvmrc）

在项目根目录创建.nvmrc文件：

# 写入所需版本echo"20.12.0">.nvmrc# 快速切换（PowerShell）nvm use(Get-Content .nvmrc)

💡团队协作最佳实践：将.nvmrc提交到 Git，确保团队环境一致

🧩 常见问题与解决方案

❌ 问题1：nvm use报错 “Access is denied”

原因：权限不足，无法创建符号链接

解决方案：

1. 以管理员身份运行终端
2. 检查C:\Program Files\nodejs目录权限
3. 尝试重新安装 NVM

❌ 问题2：切换版本后 npm 失效

原因：每个 Node 版本自带独立的 npm

解决方案：

# 重新切换版本nvm use<version>--reinstall-packages-from=<version># 或手动重新安装 npmnpminstall-gnpm@latest

❌ 问题3：下载速度慢或失败

解决方案：配置国内镜像（见进阶技巧部分）

❌ 问题4：nvm 命令不生效

解决方案：

1. 检查环境变量 PATH 是否包含 NVM 路径
2. 重启终端或电脑
3. 重新安装 NVM

📊 版本选择建议

🎯最佳实践：

• 新项目优先使用最新 LTS 版本
• 老项目根据package.json的 engines 字段选择

🔚 总结

通过 NVM for Windows，你可以：

✅轻松管理多个 Node.js 版本
✅一键切换开发环境
✅避免版本冲突
✅提高团队协作效率

常用命令组合：

# 安装并使用 LTS 版本nvminstalllts&&nvm use lts&&nvmaliasdefault lts# 安装多个版本nvminstall18&&nvminstall20&&nvminstall22# 查看当前版本nvm current# 切换版本nvm use18

📌 参考资源

• 🔗 NVM for Windows GitHub
• 🔗 Node.js 官网
• 🔗 npmmirror 镜像站

📌推荐阅读

服务端渲染(SSR)技术详解：原理、实现与应用场景
前端开发中容易被忽视但至关重要的细节优化
深入理解SEO工作原理：从抓取到排名的完整技术指南
前端开发中的SEO与渲染策略：Meta标签、SSO与SSR深度解析
URLSearchParams详解：轻松处理URL查询参数
encodeURIComponent 详解：项目中的应用场景与原理分析
深入理解JavaScript复制功能：navigator.clipboard API完全指南
实战：基于MyMemory API实现中英文翻译功能