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-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 发布页：
👉
下载
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
浙公网安备 33010602011771号