用途:面向 React 与 Next.js 应用的性能优化指南,由 Vercel 维护,供在编写新组件或页面、实现数据获取(客户端或服务端)、代码性能审查、重构旧代码、优化包体积与加载时间时参考。
主要能力:包含 8 个类别共 45 条规则,并按影响优先级排列。1) 消除瀑布流(CRITICAL,async-):延迟 await、Promise.all() 并行、处理部分依赖、API 路由提前启动 promise、Suspense 流式内容。2) 包体积优化(CRITICAL,bundle-):直接导入避免 barrel 文件、next/dynamic 动态导入、水合后再加载第三方分析/日志、按需加载模块、悬停/聚焦预加载。3) 服务端性能(HIGH,server-):React.cache() 请求级去重、LRU 跨请求缓存、减少传给客户端组件的数据、并行化获取、after() 非阻塞操作。4) 客户端数据获取(MEDIUM-HIGH,client-):SWR 自动去重、全局事件监听去重。5) 重渲染优化(MEDIUM,rerender-):延迟读取、记忆化昂贵组件、原始类型依赖、派生布尔订阅、函数式 setState、惰性状态初始化、startTransition。6) 渲染性能(MEDIUM,rendering-):动画包裹层而非 SVG 本身、content-visibility 长列表、静态 JSX 提升、降低 SVG 精度、内联脚本避免水合闪烁、Activity 组件显隐、三元而非 && 条件渲染。7) JavaScript 性能(LOW-MEDIUM,js-):批量 DOM/CSS 变更、索引 Map、缓存属性访问、缓存函数结果、缓存 storage 读取、合并迭代、先查长度、提前返回、提升正则、循环求最值、Set/Map 查找、toSorted() 不可变。8) 高级模式(LOW,advanced-):事件处理器存入 ref、useLatest 稳定回调引用。
使用方式:逐条阅读规则文件获取说明与代码示例,如 rules/async-parallel.md、rules/bundle-barrel-imports.md、rules/_sections.md;每个规则文件含原因说明、错误示例、正确示例与补充参考。完整指南见 AGENTS.md。
限制:资料未提供具体安装命令、运行环境要求、版本兼容范围与定价信息,暂未提供。