用途:面向 React 应用的性能优化与正确性审查指南,适用于编写或审查 React 组件与 Hook、优化重渲染性能、重构状态管理或副作用逻辑、审查涉及 React 代码的拉取请求时参考。
主要能力:包含 23 条规则,分为 4 类并按影响优先级排列。第一类“React 规则”(CRITICAL,前缀 react-rules-,3 条):组件与 Hook 必须纯函数、渲染期间无副作用;只在顶层和 React 函数中调用 Hook;不要像函数一样调用组件或把 Hook 当值传递。第二类“重渲染优化”(MEDIUM,前缀 rerender-,13 条):不要在组件内定义组件、在渲染中派生状态而非副作用、提取 memo 化子组件、将默认的非原始类型 props 提升到 memo 外、简单原始表达式不用 useMemo、不要在仅回调使用的状态上订阅、effect 依赖用原始值、订阅派生布尔值而非原始对象、用函数式 setState 保持回调稳定、昂贵值用惰性初始化、把交互逻辑从 effect 移到事件处理器、非紧急更新用 startTransition、频繁变化的瞬态值用 ref。第三类“渲染性能”(MEDIUM,前缀 rendering-,5 条):静态 JSX 提升到组件函数外、条件渲染用三元而非 &&、优先用 useTransition 而非手动 loading 状态、长列表用 CSS content-visibility: auto、用 Activity 组件保留隐藏 UI 状态。第四类“高级模式”(LOW,前缀 advanced-,2 条):用 ref 存最新事件处理器以获得稳定回调、应用级单例只初始化一次。
使用方式:查阅各规则文件获取说明与代码示例,如 rules/react-rules-purity.md、rules/rerender-no-inline-components.md;每个规则文件含原因简述、错误示例、正确示例和参考链接。
限制与纪律:不得降级 CRITICAL 违规;发现 CRITICAL 违规(如 react-rules-purity)应先修复再判断严重性,拒绝“幂等所以 Strict Mode 双重渲染没问题”“实际能跑”等合理化借口;重构后需对修改代码重新执行完整规则检查,因为修复一条规则可能引入另一条违规。具体版本、许可、价格等信息暂未提供。