在 Windows 上用 nvm 管理多版本 Node.js

张可爱
150 阅读3分钟

第一步：下载安装包

下载 nvm-windows 安装器

注意
nvm 会自动下载并管理 Node.js
不需要提前单独安装 Node.js

第二步：彻底卸载旧版 Node.js（非常重要）

2.1 卸载 Node.js 程序

  1. Win + I 打开 设置
  2. 进入 应用 → 应用和功能
  3. 搜索 node
  4. 找到 Node.js
  5. 点击 卸载 → 确认

2.2 删除 Node.js 残留文件

删除 D 盘里的 Node 目录

  1. 打开 此电脑
  2. 进入 D:node多版本安装与切换
  3. 找到 nodeJS 文件夹
  4. 右键 → 删除

如果不放心，可以先改名为：nodeJS_backup

删除 AppData 里的 npm 缓存

  1. Win + R
  2. 输入：
%appdata%
  1. 删除以下文件夹（如果存在）：
npm
npm-cache

2.3 清理环境变量（关键步骤）

打开环境变量设置

  1. 按 Win 键，搜索 环境变量
  2. 点击 编辑系统环境变量
  3. 点击右下角 环境变量

🧹 清理【用户变量】（上半部分）

  • 如果存在 NODE_PATH → 删除

  • 编辑 Path：

    • 删除所有包含以下内容的路径：

      • D:\nodeJS
      • 旧的 node
      • 旧的 npm

清理【系统变量】（下半部分）

  • 同样操作：

    • 删除 NODE_PATH
    • 删除 Path 中所有 Node / npm 旧路径

一路点击 确定 保存

第三步：安装 nvm-windows

  1. 双击桌面的 nvm-setup.exe
  2. 勾选 I accept the agreement → Next
  3. 选择 nvm 安装路径：
D:\nodeJS\nvm
  1. 选择 Node.js 快捷方式路径：
D:\nodeJS\nodejs
  1. 点击 Install
  2. 安装完成后点击 Finish

nvm 会自动配置的环境变量

NVM_HOME     = D:\nodeJS\nvm
NVM_SYMLINK = D:\nodeJS\nodejs

并自动加入到 Path 中：

%NVM_HOME%
%NVM_SYMLINK%

第四步：验证 nvm 是否安装成功

必须关闭所有 PowerShell / CMD 窗口，再重新打开一个新的

nvm version

预期结果

1.1.12

如果提示“找不到命令”，重启电脑后再试

第五步：安装多个 Node.js 版本

5.1 设置国内镜像（强烈推荐）

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

5.2 安装 Node.js 22.16.0（日常使用）

nvm install 22.16.0

看到 Installation complete 即成功

5.3 安装 Node.js 12.22.12（老项目用）

nvm install 12.22.12

5.4 设置默认 Node 版本

nvm use 22.16.0

5.5 验证版本

node -v
nvm list

预期输出：

* 22.16.0 (Currently using 64-bit executable)
  12.22.12

第六步：配置 npm 全局包路径（重要）

目的：
避免切换 Node 版本后，全局 npm 包丢失

执行以下命令：

mkdir D:\nodeJS\node_global
mkdir D:\nodeJS\node_cache

npm config set prefix "D:\nodeJS\node_global"
npm config set cache  "D:\nodeJS\node_cache"

第七步：手动添加全局包路径到环境变量

  1. 搜索 环境变量
  2. 打开 编辑系统环境变量
  3. 点击 环境变量
  4. 在【用户变量】中编辑 Path
  5. 新增一条：
D:\nodeJS\node_global
  1. 一路点击 确定

最终环境变量结构（参考）

系统变量

NVM_HOME     = D:\nodeJS\nvm
NVM_SYMLINK = D:\nodeJS\nodejs

Path 包含：
%NVM_HOME%
%NVM_SYMLINK%

用户变量

Path 包含：
D:\nodeJS\node_global

第八步：日常使用方式

普通项目（默认 Node 22）

node -v
# v22.16.0

运行项目（Node 12）

cd F:\project\milktea\milktea-admin-ui
nvm use 12.22.12
node -v
npm run dev

💡 关闭当前窗口后
其他 PowerShell 仍然是 Node 22，互不影响

常用 nvm 命令速查

nvm list
nvm use 22.16.0
nvm use 12.22.12
node -v
nvm install 18.20.0
nvm uninstall 12.22.12

完成检查清单（强烈建议自查）

  • 已卸载旧 Node.js
  • 删除了 D:\nodeJS 旧目录
  • 清理了环境变量里的旧 Node 路径
  • nvm 安装在 D:\nodeJS\nvm
  • nvm version 正常显示
  • 已安装 Node 22.16.0
  • 已安装 Node 12.22.12
  • nvm use 22.16.0 生效
  • npm prefix / cache 已配置
  • D:\nodeJS\node_global 已加入 Path
avatar
文章
阅读
粉丝