Windows 下使用 nvm 安装与管理 Node.js

设置 Node.js 的符号链接路径（建议设为：C:\Program Files\nodejs）

💡 这个路径将作为 node 命令的入口，必须不含空格和中文

设置 nvm 安装路径（建议默认：C:\Users\admin\AppData\Local\nvm）

解压（如果下载的是 zip）或直接运行 nvm-setup.exe

✅ 安装完成后，nvm 会自动配置好环境变量。

三、验证 nvm 是否安装成功

1. 输入以下命令：

以管理员身份打开 命令提示符（CMD） 或 PowerShell

（部分操作需要管理员权限）

nvm version 

如果显示版本号（如 1.1.12），说明 nvm 安装成功！

🔍 如果提示 'nvm' 不是内部或外部命令，请检查：是否完全卸载了旧版 Node.js、是否重启了终端（或重启电脑）、环境变量是否包含 nvm 路径（通常安装程序会自动添加）

四、使用 nvm 安装 Node.js

1. 查看可安装的 Node.js 版本

nvm list available 

这会列出所有官方支持的 LTS 和 Current 版本。

2. 安装指定版本（推荐 LTS）

例如安装最新的 LTS 版本（如 20.12.0）：

nvm install 20.12.0 

显示如下如图则安装完成

也可以只指定主版本号，nvm 会自动安装该系列的最新版：

nvm install 18 

3. 查看已安装的版本

nvm list 

输出示例：

五、切换 Node.js 版本

使用 nvm use 命令激活某个版本：

nvm use 20.12.0 

成功后会提示：

验证当前版本：

node -v # 输出 v20.12.0
npm -v # 显示对应 npm 版本 

✅ 切换后，node 和 npm 命令会自动指向所选版本。

六、常用 nvm 命令速查

1. 基础信息类命令

2. 安装与卸载 Node.js

安装命令

✅ 安装时会自动下载并解压到 nvm root 目录下的对应版本文件夹。

卸载命令

⚠️ 注意：必须先 nvm use 切换到其他版本，才能卸载当前版本。

3. 版本查看与切换

✅ 切换成功后，node -v 和 npm -v 会立即反映新版本。

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

💡 设置默认版本后，每次打开新的 CMD/PowerShell，都会自动使用该版本，无需手动 nvm use。

5. 配置镜像源（加速下载）

nvm 默认从官方 nodejs.org 下载，国内用户可能很慢。可通过修改配置文件启用国内镜像。

步骤：

1. 找到 nvm 安装目录
2. 编辑 settings.txt 文件（若不存在则新建）
3. 添加以下两行：

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

✅ 保存后，后续 nvm install 将自动从淘宝 NPM 镜像（npmmirror.com）下载，速度大幅提升！

6. 清理与维护

7. 高级技巧 & 实用组合

1. 快速安装并使用 LTS 版本

nvm install lts
nvm use lts
nvm alias default lts 

2. 同时安装多个常用版本

nvm install 18
nvm install 20
nvm install 22 

3. 查看某个项目所需的 Node 版本（配合 .nvmrc）

如果项目根目录有 .nvmrc 文件（内容如 18.17.0），可快速切换：

nvm use 

⚠️ 注意：nvm-windows 不原生支持 .nvmrc 自动读取，但你可以手动执行：

nvm use $(Get-Content .nvmrc) 

4. 检查是否为 64 位版本

nvm-windows 默认安装 64 位。可通过以下命令确认：

node -p "process.arch" 

输出应为 x64。

七、常见问题解决

❌ 问题 1：nvm use 报错 'exit status 1: Access is denied.'

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

解决方法：

• 以管理员身份运行 CMD 或 PowerShell
• 或在安装 nvm 时，确保目标路径（如 C:\Program Files\nodejs）有写入权限

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

原因：npm 是随 Node.js 一起安装的，每个版本自带独立的 npm。

解决方法：

• 确保使用 nvm use 正确切换
• 不要手动修改 PATH 中的 npm 路径

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

解决方法：配置国内镜像（需手动修改 nvm 设置文件）

1. 打开 nvm 安装目录（C:\Users\admin\AppData\Local\nvm）
2. 编辑 settings.txt，添加：

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

八、总结

通过 nvm-windows，你可以在 Windows 上：

• 轻松安装多个 Node.js 版本
• 一键切换项目所需的运行环境
• 避免版本冲突和重复安装的烦恼

这对于前端开发者、全栈工程师或参与多个项目的团队成员来说，是必备的开发利器。

🎯 最佳实践建议：日常开发使用 LTS 版本（如 18、20、22），用 nvm alias default 设置主力版本，定期清理不用的旧版本：nvm uninstall 16.14.0

参考资料：

• nvm-windows 官方 GitHub：https://github.com/coreybutler/nvm-windows
• Node.js 官网：https://nodejs.org
• 国内镜像站（npmmirror）：https://npmmirror.com