该技能是 Vercel Engineering 维护的 React 与 Next.js 性能优化指南,包含 45 条规则,按影响程度分为 8 个类别,用于指导自动化重构与代码生成。
适用场景:编写新的 React 组件或 Next.js 页面;实现客户端或服务端数据请求;审查代码中的性能问题;重构现有 React/Next.js 代码;优化打包体积或加载时间。
规则按优先级分为:
- 消除异步瀑布(CRITICAL,async- 前缀):将 await 移入实际使用的分支;独立操作使用 Promise.all();部分依赖使用 better-all;在 API 路由中尽早启动 Promise 并延后 await;使用 Suspense 流式传输内容。
- 打包体积优化(CRITICAL,bundle- 前缀):直接导入,避免桶文件;对重型组件使用 next/dynamic;在水合后加载分析或日志;仅在功能激活时加载模块;在悬停或聚焦时预加载以提升感知速度。
- 服务端性能(HIGH,server- 前缀):使用 React.cache() 做按请求去重;跨请求缓存使用 LRU;减少传给客户端组件的数据;重构组件以并行获取;使用 after() 执行非阻塞操作。
- 客户端数据获取(MEDIUM-HIGH,client- 前缀):使用 SWR 自动去重请求;去重全局事件监听器。
- 重渲染优化(MEDIUM,rerender- 前缀):不要订阅仅在回调中使用的状态;将昂贵工作提取到记忆化组件;在 effect 中使用原始类型依赖;订阅派生的布尔值而非原始值;使用函数式 setState 保持回调稳定;为昂贵初始值向 useState 传入函数;对非紧急更新使用 startTransition。
- 渲染性能(MEDIUM,rendering- 前缀):对 div 包装器而非 SVG 元素做动画;长列表使用 content-visibility;将静态 JSX 提取到组件外;降低 SVG 坐标精度;仅客户端数据使用内联脚本避免闪烁;使用 Activity 组件控制显示/隐藏;条件渲染使用三元而非 &&。
- JavaScript 性能(LOW-MEDIUM,js- 前缀):通过类或 cssText 批量修改 CSS;为重复查找构建 Map;在循环中缓存对象属性;在模块级 Map 中缓存函数结果;缓存 localStorage/sessionStorage 读取;合并多个 filter/map 为一次循环;在昂贵比较前检查数组长度;函数提前返回;将 RegExp 创建提升到循环外;用循环代替 sort 求最小值或最大值;使用 Set/Map 实现 O(1) 查找;使用 toSorted() 保持不可变性。
- 高级模式(LOW,advanced- 前缀):将事件处理器存储在 ref 中;使用 useLatest 获得稳定的回调 ref。
使用方式:阅读各规则文件(如 rules/async-parallel.md、rules/bundle-barrel-imports.md、rules/_sections.md)获取详细说明与代码示例;每个规则文件包含重要性简述、带说明的错误代码示例、带说明的正确代码示例以及补充背景与参考。完整指南(所有规则展开)见 AGENTS.md。