SuperAPI AI 工具集

react-best-practices

前端与建站

查看项目

更新于 10-15 23:33

技能介绍

用途:在审查 React 代码库质量(而非仅正确性)时使用,帮助判断是否拆分组件、是否提升状态、评估 prop API 设计,以及诊断不必要的重渲染或过早优化。

主要能力与关键模式: 单一职责组件:若无法用一个不含“and”的名词短语描述组件,就应拆分。 Prop 数量信号:3–5 个可接受,6 个以上是坏味道,8 个以上触发拆分;建议传结构化数据对象。 避免布尔 prop 陷阱:互斥布尔值说明缺少 variant prop,应改用 variant 或 state 枚举。 状态放置阶梯:状态放在最低公共祖先,按 local state → 提升到父级 → Context → 全局 store 逐级升级。 测试行为而非实现:测试用户可见结果,若行为无变化的重构导致测试失败,说明测试写错了。 避免过早 memo/callback:useMemo、useCallback 有开销,应先分析再优化。 避免内联对象/数组 prop:每次渲染产生新引用会破坏 memo 并触发子组件重渲染,应提取为常量或稳定引用。

使用方式:按症状定位原因并修复,例如 prop 穿透 3 层以上说明状态过高或未就近放置;组件文件超过 200 行说明职责过多;useEffect 中混合 fetch 与转换逻辑应抽成自定义 hook;父组件每次渲染都导致子组件重渲染通常是内联对象/数组 prop 所致。

适用场景:React 代码质量审查、组件架构决策、PR 合并前的 prop API 评估、性能问题诊断。

限制:不适用于 Hooks 规则或 useEffect 依赖(用 react 技能)、TypeScript 注解(用 typescript)、Redux 模式(用 redux-toolkit)。资料未提供安装命令、收费或平台信息。