Vue 2 到 Vite 升级助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2fae1490/vue2-vite-upgrade 到当前 AI 助手中。
技能介绍
解决的问题
Vue 2 项目长期使用 Webpack 后,常常遇到开发启动慢、构建逻辑分散在 build/ 与 config/、环境变量依赖 process.env.VUE_APP_*、静态资源路径和组件导入方式不统一等问题。直接删除旧配置换成 Vite,容易引入路由、代理、样式穿透和第三方库兼容故障。
工作方式
该技能按“分析、清理、迁移、验证、可选部署”推进。先读取 package.json,区分业务依赖与 Webpack/Babel 依赖,并检查代理、SVG Sprite、JSX、动态路由等能力;同时对 axios 做版本与拦截逻辑审计。随后删除旧构建文件,新增 vite.config.js 与 .env.* 配置,并把 static、~@、global、.vue 导入等写法迁移到 Vite 约定。对历史代码,它会优先使用 import.meta.env,但也保留 process.env.VUE_APP_* 的静态兼容映射,避免并行分支合并时出现环境断裂。最后通过开发服务、构建产物和关键页面功能验证迁移结果。
适用边界
它适合已有 Vue 2 和 Webpack/Vue CLI 结构的项目升级,不适合完全重构技术栈或 Vue 3 迁移。执行前必须有 Git 或可靠备份;如果项目存在非静态 process.env[key] 访问、深度自定义 loader,或需要保留旧部署链路,需要额外人工评估。
使用场景
- 接手 Vue 2 Webpack 老项目,想删除旧 build 与 config 目录并启用 Vite 开发服务。
- 旧代码仍依赖 process.env.VUE_APP_*,需在 Vite 保留静态写法并新增 VITE_ 变量。
- 准备把静态资源从 static 迁到 public,并修复 .vue 导入、deep 样式和代理配置。
- 上线前需要跑 pnpm run build:stage 与 preview,确认页面、路由、API 和图标可用。
适合人员
- 负责维护 Vue 2 管理后台的前端工程师,希望在不重写业务逻辑的情况下换到 Vite。
- 接手旧 Vue CLI 项目的资深工程师,需要清理 Webpack/Babel 依赖并确认环境变量兼容。
- 负责部署流水线的平台工程师,需要验证 Vite 构建产物并配置可选 FTP 部署脚本。
- 负责旧系统改造的前端负责人,需要审计 axios 拦截、上传、登录态和依赖版本。