Windows下nvm-windows切换Node.js多版本

脚本专家

nvm-windows 是 Windows 下管理多个 Node.js 版本的命令行工具，核心用途是安装、切换、查看和卸载不同 Node.js 版本，避免项目之间的运行时冲突。以下流程基于原文整理，重点保留安装前清理、镜像配置、常用命令、项目级版本控制和常见错误处理。

一、安装前先清理旧 Node.js 环境

先执行 node -v。如果能输出版本号，说明系统已有 Node.js，需要先卸载；如果没有输出，可继续安装 nvm-windows。卸载时打开“控制面板” → “程序和功能”，找到所有包含“Node.js”字样的程序并卸载。随后以管理员身份运行 PowerShell，清理残留目录：

2. Remove-Item -Path "C:\Program Files\nodejs" -Recurse -Force -ErrorAction SilentlyContinue
3. Remove-Item -Path "C:\Program Files (x86)\nodejs" -Recurse -Force -ErrorAction SilentlyContinue
4. Remove-Item -Path "$env:APPDATA\npm" -Recurse -Force -ErrorAction SilentlyContinue
5. Remove-Item -Path "$env:APPDATA\npm-cache" -Recurse -Force -ErrorAction SilentlyContinue

复制代码

接着按 Win + R 输入 sysdm.cpl，打开“系统属性” → “高级” → “环境变量”，在“系统变量”和“用户变量”的 Path 中删除所有包含 nodejs 或 npm 的路径条目。最后在命令提示符执行 where node，如果返回“信息: 未找到匹配的文件”，说明清理完成。

二、安装 nvm-windows 并验证

从 nvm-windows 官方 GitHub Releases 页面下载最新版 nvm-setup.exe。右键选择“以管理员身份运行”，按向导完成安装。安装路径建议使用默认路径，例如 C:\Users\<用户名>\AppData\Roaming\nvm，或选择无空格、无中文的路径，如 D:\nvm。安装后在命令提示符执行 nvm version，能显示版本号即表示安装成功。

三、配置镜像源解决下载慢

国内环境下载 Node.js 和 npm 可能较慢，可在 nvm 安装目录中找到 settings.txt，例如 D:\nvm\settings.txt，用记事本追加以下内容：

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

复制代码

配置完成后，nvm 安装 Node.js 和 npm 时会走对应镜像地址。

四、nvm 核心命令与参数含义

查看可安装版本使用 nvm list available；安装 LTS 版本可使用 nvm install 18.20.4，安装最新版使用 nvm install latest，安装特定版本使用 nvm install 16.20.2。查看已安装版本使用 nvm ls 或 nvm list，输出中 * 表示当前正在使用的版本。切换版本使用 nvm use 20.20.2，切换时可能需要以管理员身份运行命令提示符。切换后用 node -v 和 npm -v 验证当前版本。卸载指定版本使用 nvm uninstall 16.20.2。

2. nvm list available
3. nvm install 18.20.4
4. nvm install latest
5. nvm install 16.20.2
6. nvm ls
7. nvm list
8. nvm use 20.20.2
9. node -v
10. npm -v
11. nvm uninstall 16.20.2

复制代码

nvm on 和 nvm off 分别用于启用和禁用 nvm，属于命令速查中的控制类命令。

五、按项目切换版本的实战场景

维护老项目时，如果项目需要 Node 14，可切换后进入项目安装依赖并启动：

2. nvm use 14.21.3
3. cd my-legacy-project
4. npm install
5. npm run dev

复制代码

开发新项目需要 Node 18 时：

2. nvm use 18.20.4
3. cd my-new-project
4. npm install
5. npm start

复制代码

同一台机器上切换 Vue 2 与 React 18 项目时，可分别进入目录后执行 nvm use，再运行对应 npm 脚本：

2. cd d:\projects\vue2-admin
3. nvm use 14.21.3
4. npm run dev
6. cd d:\projects\react18-app
7. nvm use 18.20.4
8. npm start

复制代码

六、用 .nvmrc 做项目级版本控制

在项目根目录创建 .nvmrc 文件，写入需要的 Node.js 版本，例如：

2. 16.20.2

复制代码

然后在项目目录执行 nvm use，nvm 会自动读取 .nvmrc 并切换到对应版本。团队协作时应将 .nvmrc 纳入版本控制，以保证成员使用一致的 Node.js 版本。

七、常见问题与排查

问题 1：执行 nvm use 报错“exit status 1: Access is denied.”。原因是权限不足导致符号链接创建失败，解决方式是使用管理员身份运行命令提示符。

问题 2：切换版本后 npm 命令失效。原因通常是之前的 Node.js 安装未完全清除，应检查并删除残留的 Node.js 目录，然后重新执行 nvm use。

问题 3：下载速度慢或失败。原因是没有配置国内镜像源，按 settings.txt 中的 node_mirror 和 npm_mirror 配置淘宝镜像源后重试。

整体上，nvm-windows 的落地流程可以归纳为：清理旧环境、安装并验证 nvm、配置镜像、用 nvm install 安装版本、用 nvm use 切换版本、用 .nvmrc 固定项目版本，并针对权限和残留环境问题做排查。