用途:从 React 官方文档提炼的 React 开发原则,共 52 条规则、8 个类别,按对代码质量与可维护性的影响排序,用于指导编写 React 组件、管理状态、同步外部系统以及调试异常重渲染或陈旧状态等问题。
主要能力:八类规则按优先级排列,前缀区分主题。组件纯度(pure-,高):渲染期间不修改外部变量、相同输入相同输出、渲染顺序无关、副作用放入事件处理器、props 视为只读、用 StrictMode 检测纯度违规,Effect 作为最后手段。状态结构(state-,高):分组相关状态、用枚举避免矛盾状态、不存储可推导值、存 ID 而非重复对象、扁平化深层嵌套、不用 props 初始化 state、始终创建新对象与数组、理解状态快照、顺序更新用更新函数、用 key 重置状态。状态共享(share-,高):状态提升到最近公共祖先、单一数据源、受控与非受控模式、数据向下事件向上、用组合避免逐层传递、组件标识影响状态。Effect 模式(effect-,高):用于同步外部系统、提供清理函数、依赖数组完整、拆分独立同步、以同步/取消同步而非生命周期思考、不用于派生状态或事件响应、正确处理数据获取、不抑制 linter 依赖警告、移除不必要的 Effect。Refs(ref-,中):作为逃生舱、渲染期间不读写、用于 DOM 操作与计时器等可变值。Reducer(reducer-,中):何时替代 useState、动作描述发生了什么、必须纯函数、标准结构、从组件中抽离到独立文件。Context(context-,中):何时使用、创建/使用/提供模式、与 reducer 组合、有意义的默认值。事件处理(event-,中):传递处理器而非内联调用、副作用属于处理器、事件传播与 stopPropagation、handle/on 命名约定。
使用方式:在编写使用 hooks 的 React 组件、管理组件与应用状态、与外部系统(API、浏览器 API)同步、调试意外重渲染或陈旧状态、为复杂 UI 组织状态、在 state、refs、context 与 reducer 之间做选择时参考这些规则;可阅读各参考文件获取详细说明与代码示例,完整指南见 AGENTS.md。
适用场景:React 应用的组件设计与状态架构、代码审查、性能与正确性问题排查。
限制:以上为从资料整理的内容,未提供安装命令、收费或价格信息、许可协议及具体平台支持等,暂未提供。