用途:本技能提供 React 与 Next.js 应用的性能优化指南,由 Vercel 维护,共 57 条规则、分 8 个类别,按影响程度排序,用于指导自动重构与代码生成。
适用时机:编写新的 React 组件或 Next.js 页面;实现客户端或服务端数据获取;审查代码中的性能问题;重构现有 React/Next.js 代码;优化打包体积或加载时间。
规则分类(按优先级):
- 消除请求瀑布(CRITICAL,前缀 async-):如将 await 移入实际使用的分支、对独立操作用 Promise.all()、用 better-all 处理部分依赖、API 路由中提前启动 Promise 并延迟 await、用 Suspense 流式输出内容。
- 打包体积优化(CRITICAL,bundle-):直接导入避免桶文件、用 next/dynamic 加载重型组件、水合后再加载分析/日志、按功能激活加载模块、悬停/聚焦时预加载。
- 服务端性能(HIGH,server-):像 API 路由一样认证 server actions、用 React.cache() 做单请求去重、用 LRU 缓存跨请求缓存、避免 RSC props 重复序列化、减少传给客户端组件的数据、重构组件并行获取、用 after() 执行非阻塞操作。
- 客户端数据获取(MEDIUM-HIGH,client-):用 SWR 自动去重请求、去重全局事件监听器、滚动用 passive 监听、localStorage 数据版本化与最小化。
- 重渲染优化(MEDIUM,rerender-):不订阅仅回调使用的状态、将昂贵工作提取为记忆化组件、提升默认非原始类型 props、effect 使用原始类型依赖、订阅派生布尔值、渲染期派生状态而非 effect、用函数式 setState 稳定回调、对昂贵初值传函数给 useState、避免对简单原始值用 memo、将交互逻辑放入事件处理器、用 startTransition 处理非紧急更新、用 ref 保存瞬时频繁值。
- 渲染性能(MEDIUM,rendering-):动画 div 包裹层而非 SVG 元素、长列表用 content-visibility、静态 JSX 提取到组件外、降低 SVG 坐标精度、客户端数据用内联脚本避免闪烁、抑制预期不匹配警告、显示/隐藏用 Activity 组件、条件渲染用三元而非 &&、加载状态优先用 useTransition。
- JavaScript 性能(LOW-MEDIUM,js-):通过类或 cssText 批量改 CSS、重复查找建 Map、循环中缓存对象属性、模块级 Map 缓存函数结果、缓存 storage 读取、合并多个 filter/map 为一次循环、昂贵比较前先检查数组长度、函数提前返回、RegExp 创建提到循环外、用循环求 min/max 而非排序、用 Set/Map 做 O(1) 查找、用 toSorted() 保持不可变。
- 高级模式(LOW,advanced-):事件处理器存入 ref、每次应用加载只初始化一次、用 useLatest 获得稳定回调 ref。
使用方式:阅读各规则文件获取详细说明与代码示例,例如 rules/async-parallel.md、rules/bundle-barrel-imports.md。每个规则文件包含重要性简述、错误代码示例及说明、正确代码示例及说明、补充背景与参考。完整指南见 AGENTS.md。
限制:资料未提供安装命令、价格或平台支持信息,暂未提供。