react-patterns 是一份面向构建生产级 React 应用的原则性指南，以分类表格和规则条目的形式组织内容，重点在于帮助开发者在设计、状态管理、性能与测试等环节做出有依据的选择。该资料未提供安装命令、依赖信息或代码示例，以下内容均按资料陈述整理。
用途与定位 该指南面向 React 应用开发，目标是提供可遵循的工程约定，而非可运行的库或模板。内容按主题分节，包括组件设计、Hook 模式、状态管理选择、React 19 模式、组合模式、性能原则、错误处理、TypeScript 模式、测试原则与反模式。
主要能力与内容要点 组件设计：区分服务端组件、客户端组件、展示型组件与容器组件的用途和状态特征；设计规则包括每个组件单一职责、属性向下传递与事件向上传递、组合优于继承、偏好小而聚焦的组件。 Hook 模式：给出应抽取自定义 Hook 的场景，如重复的本地存储逻辑、多个防抖值、重复的请求模式、复杂表单状态；Hook 规则包括只在顶层调用、每次渲染顺序一致、自定义 Hook 以 use 开头、卸载时清理副作用。 状态管理选型：按复杂度分层，简单场景用 useState 与 useReducer，共享局部状态用 Context，服务端状态用 React Query 与 SWR，复杂全局状态用 Zustand 与 Redux Toolkit；并按作用范围给出状态放置位置。 React 19 模式：列出 useActionState（表单提交状态）、useOptimistic（乐观 UI 更新）、use（在渲染中读取资源）三个新 Hook 的用途，并说明编译器带来的自动记忆化与减少手写 useMemo、useCallback 的收益。 组合模式：介绍复合组件中父级提供上下文、子级消费上下文、基于插槽的灵活组合（如 Tabs、Accordion、Dropdown）；并对比渲染属性与 Hook 的适用场景，以及高阶组件用于横切关注点。 性能原则：给出优化触发信号与对应动作，如渲染缓慢先做性能分析、大列表虚拟化、昂贵计算用 useMemo、稳定回调用 useCallback；优化顺序为先确认是否真的慢、用 DevTools 分析、定位瓶颈、再施加针对性修复。 错误处理：按应用级、功能级、组件级说明错误边界放置位置；恢复策略包括展示回退界面、记录错误、提供重试选项、保留用户数据。 TypeScript 模式：组件属性用 interface，联合与复杂类型用 type，可复用组件用泛型；常见类型包括 ReactNode 用于 children、MouseEventHandler 用于事件处理器、RefObject 用于 ref。 测试原则：按单元、集成、端到端划分关注点；测试优先级为用户可见行为、边界情况、错误状态与可访问性。 反模式：列出避免深层属性透传（改用上下文）、避免巨型组件（拆分）、避免用 useEffect 处理一切（考虑服务端组件）、避免过早优化（先分析）、避免用索引作为 key（使用稳定的唯一 ID）。
使用方式 该资料以速查表形式提供工程约定，可按主题查阅并在团队内作为设计评审、代码审查与重构时的参考清单。资料未提供任何安装步骤、命令行工具或可执行代码示例。
适用场景与限制 适用于使用 React 与 TypeScript 的前端项目，尤其是需要在组件拆分、状态管理选型、性能优化与测试策略上建立统一约定的团队。限制在于该资料为原则性说明，未给出具体实现代码、版本兼容细节、各状态库的配置方式，也未涉及性能基准数据或工具链集成方案，这些内容暂未提供。