该技能是面向 React 与 Next.js 应用的性能优化指南,由 Vercel 维护,包含 8 个类别、共 57 条规则,并按影响程度排定优先级,用于指导自动重构与代码生成。
适用场景包括:编写新的 React 组件或 Next.js 页面;实现数据获取(客户端或服务端);审查代码中的性能问题;重构既有 React/Next.js 代码;优化打包体积或加载时间。
规则按优先级分为八类:一、消除瀑布流(关键,async- 前缀),如将 await 移入实际使用的分支、独立操作使用 Promise.all()、API 路由中尽早启动 Promise 并延后 await、用 Suspense 流式输出内容等。二、打包体积优化(关键,bundle- 前缀),如直接导入避免桶文件、对重型组件使用 next/dynamic、在 hydration 后加载分析或日志、仅在功能启用时加载模块、悬停或聚焦时预加载以提升感知速度。三、服务端性能(高,server- 前缀),如像 API 路由一样认证 Server Actions、使用 React.cache() 做单请求去重、用 LRU 缓存做跨请求缓存、减少传给客户端组件的数据、并行化数据获取、用 after() 处理非阻塞操作。四、客户端数据获取(中高,client- 前缀),如用 SWR 自动去重请求、去重全局事件监听器、滚动使用被动监听器、为 localStorage 数据加版本并精简。五、减少重渲染(中,rerender- 前缀),如不在仅回调使用的状态上订阅、抽取昂贵逻辑到 memo 组件、effects 使用原始类型依赖、订阅派生布尔而非原始值、在渲染期派生状态、使用函数式 setState、用 ref 存储瞬时高频值等。六、渲染性能(中,rendering- 前缀),如为 div 包裹层而非 SVG 元素做动画、长列表使用 content-visibility、把静态 JSX 提到组件外、降低 SVG 坐标精度、条件渲染用三元而非 &&、加载态优先用 useTransition。七、JavaScript 性能(低到中,js- 前缀),如批量 DOM/CSS 变更、为重复查找建立 Map、在循环中缓存对象属性与函数结果、合并多次 filter/map、提前返回、循环外提升 RegExp、用 Set/Map 实现 O(1) 查找、用 toSorted() 保持不可变。八、高级模式(低,advanced- 前缀),如在 ref 中存储事件处理器、每次应用加载只初始化一次、用 useLatest 获得稳定回调引用。
使用方式:可阅读各规则文件获取详细说明与代码示例,例如 rules/async-parallel.md、rules/bundle-barrel-imports.md;每个规则文件包含为何重要、错误代码示例及解释、正确代码示例及解释、额外上下文与参考。完整编译文档见 AGENTS.md。
限制:资料未提供安装命令、具体命令用法、收费或价格信息、支持平台与效果数据,这些暂未提供。