Windows 下使用 nvm 安装与管理 Node.js
在 Windows 系统下使用 nvm-windows 管理 Node.js 版本的完整流程。内容包括卸载旧版 Node.js、下载安装 nvm、验证安装、安装指定版本、切换版本以及常用命令速查。此外还涵盖了配置镜像源加速下载、设置默认版本、处理常见报错及高级技巧。通过 nvm 可实现多版本共存与灵活切换,提升开发效率。

在 Windows 系统下使用 nvm-windows 管理 Node.js 版本的完整流程。内容包括卸载旧版 Node.js、下载安装 nvm、验证安装、安装指定版本、切换版本以及常用命令速查。此外还涵盖了配置镜像源加速下载、设置默认版本、处理常见报错及高级技巧。通过 nvm 可实现多版本共存与灵活切换,提升开发效率。

在开发过程中,你可能会遇到需要同时使用多个 Node.js 版本的情况:比如一个老项目依赖 Node 16,而新项目要求 Node 20。手动反复卸载重装不仅麻烦,还容易出错。
这时,nvm(Node Version Manager) 就派上用场了!它能让你在 Windows 上轻松安装、切换和管理多个 Node.js 版本。
📌 注意:Windows 上的 nvm 并非官方版本(官方 nvm 仅支持 macOS/Linux),而是由社区维护的 nvm-windows。
本文将手把手教你如何在 Windows 10/11 上安装 nvm,并用它来管理 Node.js。
nvm 要求系统中不能预先安装 Node.js,否则会冲突。
卸载步骤:
C:\Program Files\nodejsC:\Users\<你的用户名>\AppData\Local\npmWin + R 输入 sysdm.cpl → '高级' → '环境变量'Pathnodejs 或 npm 的路径条目✅ 完成后重启命令提示符,输入
node -v应提示'不是内部或外部命令'。

打开浏览器,进入:
🔗 https://github.com/coreybutler/nvm-windows/releases
nvm-setup.zip)nvm-setup.exe(这是图形化安装程序,推荐新手使用)⚠️ 不要下载
nvm-noinstall.zip,除非你熟悉手动配置。

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

💡 这个路径将作为
node命令的入口,必须不含空格和中文
设置 nvm 安装路径(建议默认:C:\Users\admin\AppData\Local\nvm)

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

✅ 安装完成后,nvm 会自动配置好环境变量。
以管理员身份打开 命令提示符(CMD) 或 PowerShell
(部分操作需要管理员权限)
nvm version

如果显示版本号(如 1.1.12),说明 nvm 安装成功!
🔍 如果提示
'nvm' 不是内部或外部命令,请检查:是否完全卸载了旧版 Node.js、是否重启了终端(或重启电脑)、环境变量是否包含 nvm 路径(通常安装程序会自动添加)
nvm list available
这会列出所有官方支持的 LTS 和 Current 版本。

例如安装最新的 LTS 版本(如 20.12.0):
nvm install 20.12.0
显示如下如图则安装完成

也可以只指定主版本号,nvm 会自动安装该系列的最新版:
nvm install 18

nvm list
输出示例:

使用 nvm use 命令激活某个版本:
nvm use 20.12.0
成功后会提示:

验证当前版本:
node -v # 输出 v20.12.0
npm -v # 显示对应 npm 版本
✅ 切换后,
node和npm命令会自动指向所选版本。
| 命令 | 作用 | 示例 |
|---|---|---|
nvm version 或 nvm -v | 查看 nvm 自身版本 | nvm version → 1.1.12 |
nvm help | 显示所有可用命令帮助 | nvm help |
nvm root | 显示 nvm 的安装根目录(即 Node.js 版本存放路径) | nvm root → C:\Users\Alice\AppData\Roaming\nvm |
| 命令 | 说明 | 示例 |
|---|---|---|
nvm install <version> | 安装指定精确版本 | nvm install 20.12.0 |
nvm install <major> | 安装该主版本的最新版(自动补全) | nvm install 18 → 安装 18.x 最新版 |
nvm install lts | 安装最新的 LTS(长期支持)版本 | nvm install lts |
nvm install latest | 安装最新的 Current(开发版)版本 | nvm install latest |
✅ 安装时会自动下载并解压到
nvm root目录下的对应版本文件夹。
| 命令 | 说明 | 示例 |
|---|---|---|
nvm uninstall <version> | 卸载指定版本(不能卸载当前正在使用的版本) | nvm uninstall 16.14.0 |
nvm uninstall <major> | 卸载该主版本的所有子版本(不推荐) | ❌ 通常不支持,需指定完整版本号 |
⚠️ 注意:必须先
nvm use切换到其他版本,才能卸载当前版本。
| 命令 | 说明 | 示例 |
|---|---|---|
nvm list 或 nvm ls | 列出本地已安装的所有 Node.js 版本 | 显示: |
* 20.12.0 (当前) | ||
18.17.0 | ||
nvm list available 或 nvm ls available | 列出所有官方可安装的版本(含 LTS/Current 标记) | 显示远程版本列表 |
nvm use <version> | 临时切换到指定版本(仅当前终端会话有效) | nvm use 18.17.0 |
nvm use <major> | 切换到该主版本的已安装最新子版本 | nvm use 18 |
nvm current | 显示当前正在使用的 Node.js 版本 | nvm current → v20.12.0 |
✅ 切换成功后,
node -v和npm -v会立即反映新版本。
| 命令 | 说明 | 示例 |
|---|---|---|
nvm alias default <version> | 设置默认启动版本(新终端自动激活) | nvm alias default 20.12.0 |
nvm alias | 查看所有别名(包括 default) | 输出: |
default -> 20.12.0 | ||
nvm unalias default | 删除默认别名(不推荐) | — |
💡 设置默认版本后,每次打开新的 CMD/PowerShell,都会自动使用该版本,无需手动
nvm use。
nvm 默认从官方 nodejs.org 下载,国内用户可能很慢。可通过修改配置文件启用国内镜像。
settings.txt 文件(若不存在则新建)node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
✅ 保存后,后续
nvm install将自动从淘宝 NPM 镜像(npmmirror.com)下载,速度大幅提升!
| 命令 | 说明 |
|---|---|
| 手动删除旧版本 | 进入 nvm root 目录,直接删除不需要的版本文件夹(如 v16.14.0) |
| 清理 npm 缓存(可选) | npm cache clean --force(每个 Node 版本有独立缓存) |
| 重置 PATH(故障排查) | 如果 node 命令失效,检查 C:\Program Files\nodejs 是否在系统 PATH 中,并确保它是 nvm 创建的符号链接 |
nvm install lts
nvm use lts
nvm alias default lts
nvm install 18
nvm install 20
nvm install 22
.nvmrc)如果项目根目录有 .nvmrc 文件(内容如 18.17.0),可快速切换:
nvm use
⚠️ 注意:nvm-windows 不原生支持
.nvmrc自动读取,但你可以手动执行:
nvm use $(Get-Content .nvmrc)
nvm-windows 默认安装 64 位。可通过以下命令确认:
node -p "process.arch"
输出应为 x64。
nvm use 报错 'exit status 1: Access is denied.'原因:权限不足,无法创建符号链接。
解决方法:
C:\Program Files\nodejs)有写入权限npm 命令失效原因:npm 是随 Node.js 一起安装的,每个版本自带独立的 npm。
解决方法:
nvm use 正确切换解决方法:配置国内镜像(需手动修改 nvm 设置文件)
C:\Users\admin\AppData\Local\nvm)settings.txt,添加:node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
通过 nvm-windows,你可以在 Windows 上:
这对于前端开发者、全栈工程师或参与多个项目的团队成员来说,是必备的开发利器。
🎯 最佳实践建议:日常开发使用 LTS 版本(如 18、20、22),用
nvm alias default设置主力版本,定期清理不用的旧版本:nvm uninstall 16.14.0
参考资料:

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online