惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Apple Machine Learning Research
Apple Machine Learning Research
博客园_首页
G
Google Developers Blog
aimingoo的专栏
aimingoo的专栏
罗磊的独立博客
博客园 - 【当耐特】
M
MIT News - Artificial intelligence
D
Docker
博客园 - 三生石上(FineUI控件)
博客园 - 司徒正美
人人都是产品经理
人人都是产品经理
博客园 - 叶小钗
月光博客
月光博客
S
SegmentFault 最新的问题
Jina AI
Jina AI
Blog — PlanetScale
Blog — PlanetScale
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
博客园 - Franky
L
LangChain Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Microsoft Azure Blog
Microsoft Azure Blog
阮一峰的网络日志
阮一峰的网络日志
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
Last Week in AI
Last Week in AI

博客园 - JoeYoung

收官大吉,来年可期 本地部署 DeepSeek+VS Code,搭建本地大模型 电脑安装 Win10 提示无法在当前分区上安装Windows的解决办法 Ollama可以不装在C盘,安装时选择路径 Swiper 自动无缝匀速滚动 Swiper 实现奇葩需求案例 Vue+ElementUI 导出为PDF文件 table 中设置宽度被td或th里的内容撑开超出 在页面离开前提醒你的 beforeunload 事件 npm安装依赖包的多种镜像及方法 通栏中不定数量的图片/轮播自适应宽高的简单示例 微信小程序 input 不能输入特殊字符的方法 微信小程序 input中输入内容后还提示请输入的解决办法 CSS的逻辑组合伪类 CSS结构伪类选择器之否定伪类:not() jQuery 指定区域的内容循环滚动 微信小程序 scroll-view 组件的 bindscroll 不触发不生效 scroll-view 组件里的 scroll-into-view 属性实例 微信小程序 授权登录时不得默认强制用户同意隐私政策协议
nvm-windows 实现 Node 多版本管理
JoeYoung · 2026-03-07 · via 博客园 - JoeYoung

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 多版本管理的痛点:

核心价值

  1. 告别频繁重装​ - 一个命令切换版本

  2. 项目隔离​ - 不同项目用不同 Node 版本

  3. 降低环境冲突​ - 彻底解决版本兼容问题

温馨提示

  • 记得配置国内镜像加速下载

  • 切换版本需要管理员权限

  • 建议为每个项目创建 .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