一、问题背景
同一台 Windows 电脑上跑两个前端项目:
- 若依前端(vue2 / webpack) → 要求 Node 16
- Vue3 + Vite → 要求 Node 20+
结果:
- 升级 Node,若依跑不起来
- 降级 Node,Vite 报错
👉 本质:项目依赖的 Node 版本不一致
二、解决方案
使用 nvm-windows 管理多个 Node 版本,而不是反复卸载 / 重装。
三、安装 nvm-windows
官方地址:
github.com/coreybutler…
下载并安装:
nvm-setup.exe
验证安装:
nvm version
四、安装并切换 Node
# 安装
nvm install 16.20.2
nvm install 20
# 若依前端
nvm use 16
node -v
# Vite 项目
nvm use 20
node -v
⚠️ 切换 Node 后建议重新打开终端
五、原理一句话说明
nvm 不是启动 Node,而是 切换 node.exe 的指向路径,
从而控制当前终端使用的 Node 版本。
六、为什么会冲突?
- 若依前端:老依赖(node-sass / webpack),只能跑 Node 16
- Vite:使用新特性(Web Crypto API),必须 Node 20+
👉 冲突是工具链新旧差异,不是配置错误。
七、推荐使用方式
一个项目 = 一个 Node 版本
# 若依
nvm use 16 && npm run dev
# Vite
nvm use 20 && npm run dev
八、常用命令速查
nvm list
nvm install 20
nvm use 20
node -v
九、总结
- Windows 前端开发必装 nvm
- 新老项目共存是常态
- 别再手动卸载 Node
用 nvm,一次解决所有 Node 版本冲突问题