React Hooks Best Practices 是一套针对 React 应用中 Hook 使用方式与自定义 Hook 设计的实用规则集,覆盖三个视角:DX(开发体验)、优化(Optimization)和逻辑(Logic)。
用途
该规则集用于在以下场景中提供参考:编写使用 Hook 的 React 组件;创建或重构自定义 Hook;设计易用且可组合的 Hook API;审查依赖、副作用、ref、state、回调与记忆化;审查 Hook API 是否存在不必要的重渲染;审查 Hook 内部是否存在过期闭包、清理、SSR 与生命周期正确性问题;设计订阅高频更新的自定义 Hook;使用暴露 snapshot、callback 和 watch() API 的 Hook;重构在每次浏览器事件时都更新 React state 的 Hook;将贴近 DOM 的工作移出 React 渲染状态。
主要能力
规则按优先级分为三类,均为高优先级:
-
DX(前缀 dx-):dx-extract-complex-hook —— 将复杂功能逻辑移入自定义 Hook,并使用分组返回契约,例如 form、state、functions、refs、features。
-
优化(前缀 optimization-):optimization-watch-mode —— 仅在 UI 需要响应式渲染数据时使用 watch();其余高频更新保留在快照和回调中。
-
逻辑(前缀 logic-):规则标注为即将推出(Rules coming soon)。
使用方式
阅读各条规则文件以获取详细说明与示例:rules/dx-extract-complex-hook.md 和 rules/optimization-watch-mode.md。每条规则文件包含:该模式解决的问题、错误与正确代码示例、面向 Hook 作者与 Hook 使用者的指导,以及相关来源参考。完整编译概览见 AGENTS.md。
适用场景
适用于 React 组件开发、自定义 Hook 设计与重构、Hook API 审查、性能与重渲染优化、高频更新订阅处理,以及将 DOM 相关工作从 React 渲染状态中分离等场景。
限制
当前资料仅明确列出两条具体规则(dx-extract-complex-hook 与 optimization-watch-mode),逻辑类规则尚未提供。关于收费、价格、平台支持范围、具体效果等信息暂未提供。