用途:在配置、升级、扩展或排查 Vite 时使用,先做迁移检查,再打开与当前工作匹配的主题参考。
主要能力与参考主题:构建与依赖优化;开发服务器与资源;迁移与运行时要求(Node.js 支持、浏览器目标、Vitest 兼容、已移除 API);插件与框架 API(Environment API 与多环境协同构建);解析与模块互操作(ESM-only 打包、CommonJS 加载、直接导入 WebAssembly ESM);转换、TypeScript 与样式(Lightning CSS 互操作、Sass 旧 API 移除)。
升级阻塞点:先检查 node --version,Vite 7 要求 Node.js 20.19+ 或 22.12+,Node.js 18 低于下限,Node.js 21 自 Vite 6 起已不支持,需注意次版本号。升级前搜索已删除 API:rg "splitVendorChunkPlugin|legacy API" .,Vite 7 移除了 Sass 旧 API 支持和 splitVendorChunkPlugin。默认 build.target 现为 'baseline-widely-available',Vite 7 中对应 Chrome 107、Edge 107、Firefox 104、Safari 16.0,契约不同时应显式设置。Vite 7 支持从 Vitest 3.2 起。
高价值配置:可用 vite --experimental-bundle 或在配置中设置 experimental.bundledDev: true 启用实验性打包开发模式(仍保留 HMR,属实验性、有限制);build.chunkImportMap: true 可稳定 chunk 关系,不能与 experimental.renderBuiltUrl 同用;WebAssembly 可直接命名导出;html.additionalAssetSources 可扩展自定义 HTML 资源发现;import.meta.glob 支持 caseSensitive: false;css.transformer: 'lightningcss' 支持导入外部 CSS 和注册依赖。
集成与限制:实验性 Environment API 提供 buildApp 钩子;可用 rolldown-vite 替换 vite 进行试验。所有实验性选项应显式开启并验证不兼容性;资料未提供收费、价格等信息。