nvm-windows 实现 Node 多版本管理

nvm-windows 实现 Node 多版本管理

前言

在前端开发中，不同项目往往依赖不同版本的 Node.js。比如：

• Vue 2 项目可能需要 Node 12/14
• React 18 项目需要 Node 16+
• 新项目可能要求 Node 18/20
• 龙虾需要 Node 22+

频繁地重装/切换 Node 版本既麻烦又容易出问题。nvm-windows​ 就是为解决这个问题而生的神器！
⚠️ 注意：nvm-windows 是 Windows 平台专用的，Mac/Linux 用户请使用 nvm

一、nvm-windows 是什么？

nvm-windows 是 Windows 下的 Node.js 版本管理器，它可以：
功能
说明
📦 安装多个 Node 版本
同时管理 Node 10/12/14/16/18/20…
🔄 一键切换版本
不同项目用不同 Node 版本
🧹 完全隔离
各版本独立，互不干扰
💾 快速切换
无需重装，秒级切换

二、安装前准备

1、卸载现有 Node.js（先清理，避免冲突）

• 控制面板 → 程序和功能 → 删除 Node.js；

• 手动删除残留：
  C:\Program Files\nodejs 文件夹
  C:\Users[你的用户名]\AppData\Roaming\npm 文件夹

• 重启电脑，确保 node -v 提示「命令不存在」。

2. 下载 nvm-windows

访问 GitHub 发布页：
👉 https://github.com/coreybutler/nvm-windows/releases
下载 nvm-setup.exe 或者 nvm-setup.zip

三、安装 nvm-windows

1. 运行安装程序

双击 nvm-setup.exe，按以下步骤：
Step 1: 同意协议

Do you want to allow this app to make changes to your device?
→ 点击 "Yes"

Step 2: 选择 nvm 安装目录

Default: C:\Users\<用户名>\AppData\Roaming\nvm

建议：D:\dev\nvm （非系统盘，避免权限问题）

Step 3: 选择 Node.js 符号链接目录

Default: C:\Program Files\nodejs

这个目录会被 nvm 管理，用于创建软链接，也建议D盘

Step 4: 安装完成

2. 验证安装

# 打开新的 PowerShell/CMD
nvm version
# 输出版本号，如：1.1.10

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

编辑 nvm 安装目录下的 settings.txt：

root: D:\dev\nvm
path: D:\Program Files\nodejs
arch: 64
proxy: none

# 添加淘宝镜像（国内用户必加！）
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

四、基本使用教程

1. 查看可安装的 Node 版本

# 查看所有可安装的版本（精简列表）
nvm list available

# 输出示例：
# |   CURRENT    |     LTS      |  OLD STABLE  | OLD UNSTABLE |
# |--------------|--------------|--------------|--------------|
# |    25.8.0    |   24.14.0    |   0.12.18    |   0.11.16   |
# |    25.7.0    |   24.13.1    |   0.12.17    |   0.11.15   |
# |    25.6.1    |   24.13.0    |   0.12.16    |   0.11.14   |
# |    25.6.0    |   24.12.0    |   0.12.15    |   0.11.13   |
# |    25.5.0    |   24.11.1    |   0.12.14    |   0.11.12   |
# |    25.4.0    |   24.11.0    |   0.12.13    |   0.11.11   |
# |    25.3.0    |   22.22.1    |   0.12.12    |   0.11.10   |

2. 安装 Node.js

# 安装指定版本
nvm install 18.19.0

# 安装 LTS 版本
nvm install lts

# 安装最新版本
nvm install latest

# 一次安装多个版本
nvm install 16.20.2
nvm install 18.19.0
nvm install 22.13.1

3. 查看已安装的版本

nvm list
# 或
nvm ls

# 输出示例：
#     22.13.1
#     18.19.0
#   * 16.20.2 (Currently using 64-bit executable)
# 前面的 * 表示当前正在使用的版本

4. 切换 Node 版本

# 使用指定版本
nvm use 18.19.0

# 管理员权限！切换需要管理员权限
# 如果报 exit status 1，右键 PowerShell → 以管理员身份运行

5. 验证当前版本

# 查看 Node 版本
node -v
# v18.19.0

# 查看 npm 版本
npm -v
# 9.2.0

五、实战场景示例

场景 1：Vue 2 项目（Node 14）

# 切换到 Node 14
nvm use 14.21.3

# 验证
node -v  # v14.21.3

# 进入项目目录
cd my-vue2-project

# 安装依赖 & 运行
npm install
npm run serve

场景 2：React 18 项目（Node 18）

# 切换到 Node 18
nvm use 18.19.0

# 验证
node -v  # v18.19.0

# 进入项目目录
cd my-react18-project

# 安装依赖 & 运行
npm install
npm start

场景 3：快速在不同项目间切换

# 项目 A：Vue 2 + Element UI
cd d:\projects\vue2-admin
nvm use 14.21.3
npm run dev

# 项目 B：Vue 3 + Vite
cd d:\projects\vue3-app
nvm use 18.19.0
npm run dev

# 项目 C：Next.js 14
cd d:\projects\nextjs-app
nvm use 20.10.0
npm run dev

六、进阶技巧

1. 为每个项目自动切换 Node 版本

配合 .nvmrc文件实现自动切换：

# 在项目根目录创建 .nvmrc 文件
echo "18.19.0" > .nvmrc

# 进入目录时自动切换（需要 shell 支持）
# 如果使用 zsh，可在 .zshrc 中添加：
# cd() { builtin cd "$@"; if [[ -f .nvmrc ]]; then nvm use; fi; }

2. 设置默认版本

# 设置启动时默认使用的版本
nvm alias default 18.19.0

# 下次打开终端会自动使用该版本

3. 安装特定架构的 Node

# 安装 32 位版本
nvm install 18.19.0 32

# 安装 64 位版本（默认）
nvm install 18.19.0 64

4. 卸载 Node 版本

# 卸载指定版本
nvm uninstall 14.21.3

# 不能卸载当前正在使用的版本
# 需要先切换到其他版本
nvm use 18.19.0
nvm uninstall 14.21.3

5. 复制 Node 版本（离线使用）

# 导出已安装的版本列表
nvm list > installed_versions.txt

# 导出某个版本的 npm 包列表
nvm use 18.19.0
npm list --depth=0 > packages-node18.txt

七、总结

nvm-windows 是 Windows 前端开发的必备工具，它解决了 Node.js 多版本管理的痛点：

核心价值

• 告别频繁重装​ - 一个命令切换版本
• 项目隔离​ - 不同项目用不同 Node 版本
• 降低环境冲突​ - 彻底解决版本兼容问题

温馨提示

• 记得配置国内镜像加速下载
• 切换版本需要管理员权限
• 建议为每个项目创建 .nvmrc文件
• 定期清理不再使用的 Node 版本

附录：常用命令速查

# 安装
nvm install <version>      # 安装指定版本
nvm install lts            # 安装 LTS 版本
nvm install latest         # 安装最新版本

# 查看
nvm list                   # 查看已安装版本
nvm list available         # 查看可安装版本

# 切换
nvm use <version>          # 切换版本（需管理员权限）
nvm alias default <version> # 设置默认版本

# 卸载
nvm uninstall <version>    # 卸载指定版本

# 其他
nvm current                # 显示当前版本
nvm version                # 显示 nvm 版本
nvm on                     # 启用 nvm
nvm off                    # 禁用 nvm