用途:用于审查、配置、迁移和调试 Vite 项目,包括应用、库、SSR 集成与插件开发,覆盖 vite.config 文件、HMR、import.meta API 等场景。该技能基于 vite@8.2.2 稳定版整理。
主要能力:处理版本敏感任务时先确认项目实际安装的 Vite 版本;若用户要求最新版,需再核对 npm 的 latest dist-tag 并采用对应官方文档,不把仅 Vite 8 支持的选项用于旧项目,除非任务本身包含迁移。工作流程包括检查 package.json、锁文件、vite.config.*、框架插件和实际调用 Vite 的脚本,因为框架可能封装或接管 Vite 配置;把修复请求与升级请求分开,未获迁移要求时保留现有主次版本;优先使用 Vite 层选项而非底层 Rolldown/Oxc 定制;保留既有 JS/TS 与 ESM 约定;RC 与实验性 API 需显式选择并说明状态与兼容限制,依赖时锁定次版本;用仓库自带检查验证,至少运行相关 typecheck 或配置加载加生产构建,涉及 dev/HMR 或 SSR 时需实际验证。
Vite 8 配置命名:新配置或迁移后应使用现名,兼容别名仍可用但已弃用,包括 build.rollupOptions→build.rolldownOptions、worker.rollupOptions→worker.rolldownOptions、esbuild→oxc、optimizeDeps.esbuildOptions→optimizeDeps.rolldownOptions、build.minify: 'esbuild'→build.minify: 'oxc'(客户端构建默认)。不要机械重命名嵌套选项,部分 esbuild 与 Rollup 选项已变形、不再支持或需插件替代。
稳定能力:Vite 8.2 增加顶层 input,可被 dev、依赖优化、常规构建、库模式和 SSR 共享;resolve.tsconfigPaths 稳定且需显式启用,遵循 TypeScript 的 files/include 匹配,不解析 Less 导入;检测到编码智能体时自动启用 server.forwardConsole。Vite 8.1 增加大小写不敏感的 import.meta.glob、直接 WebAssembly ESM 导入与自定义 HTML 资源发现。Lightning CSS 是默认 CSS 压缩器,css.transformer: 'lightningcss' 仍为实验性,PostCSS 是默认转换器。bundled dev 模式、chunk import maps、Devtools 集成及部分 Environment API 尚未完全稳定,不应作为通用默认启用。
验证建议:使用锁文件记录的包管理器,不要重新生成不同锁文件;优先用项目脚本而非临时命令;仅验证配置时可运行真实 Vite 命令或构建;库改动需分别检查产物格式、导出、CSS 与声明生成(Vite 本身不生成 TypeScript 声明);SSR 改动需验证客户端与服务端构建及至少一次渲染请求;实验性或未验证路径需明确说明。