核心用法
本技能提供完整的Vue 2项目Webpack→Vite迁移方案，采用五阶段执行框架：
阶段1-项目分析：深度扫描package.json识别业务依赖与Webpack依赖边界，提取并转换环境变量配置，审计axios版本安全性。
阶段2-配置迁移：清理build/、config/等Webpack配置目录，创建vite.config.js及.env.文件，注入`VITE_`与`VUE_APP_`双轨兼容的环境变量映射层。
阶段3-代码适配：处理六大改造点——index.html移至根目录、main.js改用render函数、.vue导入强制加扩展名、require→import语法迁移、/deep/→::v-deep样式替换、global→window全局变量修正。
阶段4-验证闭环：通过dev启动、build打包、preview预览三级验证确保功能无损。
阶段5-部署加固（可选）：提供export-zip.cjs压缩与ftp-deploy.js自动化部署脚本。
显著优点
1. 极速构建：Vite基于ESM的HMR机制可将冷启动从分钟级降至秒级，构建速度提升10-20倍
2. 零业务入侵：严格保留业务依赖，仅删除Webpack/Babel相关依赖，避免功能回归风险
3. 双轨兼容：独创import.meta.env优先+process.env.VUE_APP_*兼容层设计，支持新老代码并行上线
4. 安全审计内置：强制axios版本安全检查，拦截已知CVE漏洞版本
5. 工程化完备：提供TodoWrite任务追踪、分阶段交付、故障排查手册(reference文档)
潜在局限
- 生态限制：Vue 2.7.x为最终版本，部分Vue 3特性无法使用；Vite插件生态较Webpack仍有差距
- 动态依赖风险：require()动态导入需手动改写为import()，无法全自动迁移
- 复杂Webpack配置：如高度定制的loader链、复杂的splitChunks策略需人工介入
- Node版本要求：Vite 3+需Node 14.18+/16+，老旧CI环境可能需升级
适合人群
- 维护 legacy Vue 2 项目但希望获得现代化开发体验的前端团队
- 受困于Webpack构建慢、配置复杂、热更新失效等痛点的开发者
- 需要在保障业务稳定前提下渐进式升级基础设施的技术负责人
- 多环境部署场景下需要统一环境变量管理方案的项目
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 迁移过程误删源文件 | 强制前置Git备份检查 |
| 依赖冲突 | 残留Webpack插件与Vite不兼容 | 阶段2精确清理+--force安装 |
| 环境变量泄露 | .env.*未纳入.gitignore | 模板内置.gitignore规则 |
| 第三方库异常 | 库内部使用process.env动态访问 | 兼容层限制静态写法，动态访问需补丁 |
| 构建产物差异 | 代码分割/公共提取策略变更 | 阶段4强制build+preview验证 |