如何使用NPM从Vite 2升级/迁移至基于Vue的Vite 3？

开发者阿泽

2026-8-17

Vite 2 升级至 Vite 3（NPM 操作指南）

以下是使用 NPM 将 Vite 2 升级到 Vite 3 的具体步骤：

确认当前 Vite 版本
先执行命令查看项目中当前安装的 Vite 版本，确保是 Vite 2 系列：
```
npm list vite
```
升级 Vite 核心包
直接安装最新版 Vite（此时会自动安装 Vite 3 稳定版）：
```
npm install vite@latest
```
也可以指定具体的 Vite 3 版本号，比如：
```
npm install vite@3.2.7
```
同步升级相关插件
Vite 3 对官方插件（如 Vue/React 插件）有版本兼容要求，需要同步升级这些依赖：
- Vue 项目：
```
npm install @vitejs/plugin-vue@latest
```
- React 项目：
```
npm install @vitejs/plugin-react@latest
```
如果你使用了其他第三方 Vite 插件（如 vite-plugin-pwa、vite-plugin-eslint 等），需要查看插件官方文档确认兼容 Vite 3 的版本，再执行对应的升级命令。
修复依赖冲突（若有）
升级后如果出现依赖冲突，可尝试以下操作：
1. 删除本地依赖目录和锁文件：
```
rm -rf node_modules package-lock.json
```
2. 重新安装所有依赖：
```
npm install
```
也可以执行 npm audit 查看具体冲突项，针对性调整版本。
验证升级结果
完成上述步骤后，测试项目是否正常运行：
- 启动开发服务器：npm run dev，检查页面加载、热更新是否正常
- 执行生产构建：npm run build，确认构建产物无异常
  若出现报错，可参考 Vite 3 迁移指南中的破坏性变更条目排查，比如 Node.js 版本要求（Vite 3 需 Node.js 14.18+ 或 16+，低于此版本需先升级 Node）、配置项默认值变更等。