SuperAPI AI 工具集

vercel-react-best-practices

编程与开发

查看项目

更新于 11-08 16:04

技能介绍

用途

该技能是一份由 Vercel Engineering 维护的 React 与 Next.js 性能优化指南,用于在编写、评审或重构 React/Next.js 代码时提供可执行的优化规则,指导自动化重构和代码生成。资料称其包含 8 个类别共 65 条规则,并按影响程度排序。

适用时机

资料列出的适用场景包括:编写新的 React 组件或 Next.js 页面;实现客户端或服务端数据获取;评审代码中的性能问题;重构现有 React/Next.js 代码;优化打包体积或加载时间。

规则分类(按优先级)

  1. 消除瀑布式请求(CRITICAL,前缀 async-):如将 await 移入实际使用的分支、用 Promise.all() 并行独立操作、在 API 路由中提前启动 Promise 并延后 await、用 Suspense 流式输出内容等。
  2. 包体积优化(CRITICAL,前缀 bundle-):如直接导入避免 barrel 文件、用 next/dynamic 加载重型组件、在水合后加载分析与日志、按功能激活加载模块、悬停/聚焦预加载等。
  3. 服务端性能(HIGH,前缀 server-):如像 API 路由一样校验 server actions、用 React.cache() 做请求内去重、用 LRU 缓存跨请求缓存、减少传给客户端组件的数据、并行化数据获取、用 after() 执行非阻塞操作等。
  4. 客户端数据获取(MEDIUM-HIGH,前缀 client-):如用 SWR 自动去重请求、去重全局事件监听、滚动使用 passive 监听、为 localStorage 数据做版本化与最小化。
  5. 重渲染优化(MEDIUM,前缀 rerender-):如不在回调中订阅状态、将昂贵计算提取为 memo 组件、使用原始类型依赖、订阅派生布尔值、在渲染期派生状态、使用函数式 setState、useState 惰性初始化、用 startTransition 处理非紧急更新、用 useDeferredValue 保持输入响应、避免组件内定义组件等。
  6. 渲染性能(MEDIUM,前缀 rendering-):如动画 div 包装而非 SVG 元素、长列表使用 content-visibility、提取静态 JSX、降低 SVG 坐标精度、用内联脚本处理仅客户端数据、抑制预期内的水合不匹配、使用 Activity 组件、条件渲染用三元而非 &&、优先使用 useTransition 处理加载状态、使用资源提示预加载、为 script 标签添加 defer 或 async。
  7. JavaScript 性能(LOW-MEDIUM,前缀 js-):如按类或 cssText 批量修改 CSS、用 Map 做重复查找、循环中缓存属性访问、缓存函数结果与存储读取、合并多次 filter/map、先检查数组长度、提前返回、将 RegExp 提升到循环外、用循环求 min/max、用 Set/Map 做 O(1) 查找、用 toSorted() 保持不可变、用 flatMap 合并映射与过滤、用 requestIdleCallback 延后非关键工作。
  8. 高级模式(LOW,前缀 advanced-):如将事件处理器存入 ref、每次应用加载只初始化一次、用 useLatest 获得稳定回调 ref。

使用方式

资料说明可阅读单条规则文件(如 rules/async-parallel.md、rules/bundle-barrel-imports.md)获取详细说明与代码示例;每条规则文件包含为何重要的简要解释、带说明的错误代码示例、带说明的正确代码示例,以及补充背景与参考。完整指南见 AGENTS.md。目录中的 AGENTS.md 是来自 Vercel 的长篇上游参考,仅作为该技能的补充材料;SKILL.md 是可加载入口与权威来源,不覆盖或扩展仓库根目录的 AGENTS.md / AGENT_GUIDE.md。

限制

资料未提供该技能的具体安装方式、依赖要求、收费信息、支持的平台或版本范围,这些事实暂未提供。