用途:在部署前审查 Vite 配置、检查常见错误、验证 Vite 项目。
使用方式:按顺序逐项执行检查,每项标记 PASS 或 FAIL;安全(Security)与配置(Configuration)关键区域出现任一 FAIL 即阻止部署,所有 FAIL 修复后才可批准代码。
主要检查区域(共 50 项): 配置 8 项,如用 defineConfig() 包裹导出、按版本使用 build.rolldownOptions(v8)或 build.rollupOptions(v6-v7)、envPrefix 不可为空、appType 匹配用法、配置文件内用 loadEnv() 而非 import.meta.env、条件配置用函数形式。 插件 11 项,如导出工厂函数、插件对象须有 name、config 钩子返回部分配置、configureServer 在 configResolved 后使用、transformIndexHtml 用 order(pre/post)而非已移除的 enforce 属性、虚拟模块前缀规则、v8 中非 JS 内容须设 moduleType: 'js'。 HMR 6 项,如所有 HMR 代码须包在 if (import.meta.hot) 中、accept( 括号前不留空格、通过属性修改 hot.data、先 accept() 后 invalidate()、用 dispose() 清理副作用、用 prune() 处理模块移除。 环境变量 5 项,如客户端仅访问 VITE_ 前缀变量、禁止把密钥放入 VITE_ 变量、在 src/vite-env.d.ts 定义 ImportMetaEnv、.env*.local 加入 .gitignore。 构建 8 项,如 build.target 匹配部署环境、生产不着意外暴露 sourcemap、保持 cssCodeSplit、库模式设 build.lib.name 并外置 peer 依赖、配置 package.json 的 main/module/exports、按版本选 minify。 SSR 6 项,如中间件模式配 appType: 'custom'、配置 ssr.noExternal、错误处理中调用 vite.ssrFixStacktrace(e)、用 import.meta.env.SSR 分支、SSR 构建加 --ssr 标志、生成 SSR manifest 以支持预加载提示。 安全 6 项,如 envPrefix 不可为空、保持 server.fs.strict、为网络暴露配置 server.allowedHosts、客户端代码不含凭据、生产限制 sourcemap、保留 server.fs.deny 默认敏感文件模式。
输出:按提供的验证汇总模板记录项目名、日期、Vite 版本(6.x/7.x/8.x)及各区域 PASS/FAIL/阻止数量,区分关键失败与非关键失败。
限制:适用 Vite 6/7/8;具体项目效果与版本差异需自行核实,本技能未提供价格、平台或效果承诺;缺失信息暂未提供。