用途:为使用 Vite 构建的 React 应用提供性能优化指南,适用于配置 Vite、实现代码分割与懒加载、优化构建产物与包体积、配置开发环境与 HMR、处理图片字体 SVG 等静态资源、管理多环境变量以及分析包体积与依赖等场景。
主要能力:共 23 条规则,分 6 类并按优先级排列。构建优化(CRITICAL,前缀 build-)含手动分包、压缩(默认 OXC 或 Terser)、现代浏览器目标、sourcemap、tree shaking、Gzip/Brotli 压缩、基于内容哈希的缓存失效;代码分割(CRITICAL,前缀 split-)含基于路由的 React.lazy()、Suspense 边界、动态 import()、非关键组件懒加载、悬停/空闲/视口预取;开发(HIGH,前缀 dev-)含 optimizeDeps 预打包、Fast Refresh、HMR 配置;资源处理(HIGH,前缀 asset-)含图片优化与懒加载、SVGR 将 SVG 转为 React 组件、字体加载策略、public 目录与 JS 导入的取舍;环境配置(MEDIUM,前缀 env-)含 VITE_ 前缀、按模式的环境文件、禁止在客户端暴露密钥;包体分析(MEDIUM,前缀 bundle-)含 rollup-plugin-visualizer。
使用方式:按需阅读各规则文件,如 rules/build-manual-chunks.md、rules/split-route-lazy.md、rules/env-vite-prefix.md;完整展开版见 REFERENCE.md。资料给出推荐 vite.config.ts 示例(含 @ 别名、build.target 为 baseline-widely-available、manualChunks 分离 react/react-dom、optimizeDeps.include、server.port 3000 与 HMR overlay),以及基于路由的 lazy/Suspense 示例和 vite-env.d.ts 环境变量类型声明示例。
限制:许可为 MIT;具体安装命令、版本要求、各规则详细代码与实测效果暂未提供。