React Patterns 是一份关于构建生产级 React 应用的原则性资料，内容以模式、规则和对照表的形式组织，覆盖从组件设计到测试的完整开发链路。
一、用途 该资料用于指导 React 应用的架构与编码实践，帮助开发者在组件划分、状态管理、性能优化、类型定义和测试等环节做出更合理的选择。它既可作为团队内部规范，也可作为个人学习现代 React 模式的参考。
二、主要能力与内容
- 组件设计原则：区分 Server、Client、Presentational、Container 等组件类型及其状态使用方式，提出单一职责、Props 向下事件向上、组合优于继承、偏好小而专注的组件等规则。
- Hook 模式：说明何时抽取自定义 Hook（如 useLocalStorage、useDebounce、useFetch、useForm），并列出 Hook 使用规则，包括仅在顶层调用、每次渲染顺序一致、自定义 Hook 以 use 开头、卸载时清理副作用。
- 状态管理选型：按复杂度给出方案，简单场景用 useState/useReducer，共享局部状态用 Context，服务端状态用 React Query/SWR，复杂全局状态用 Zustand/Redux Toolkit；并按作用域说明状态放置位置。
- React 19 模式：介绍 useActionState（表单提交状态）、useOptimistic（乐观 UI 更新）、use（在渲染中读取资源）等新 Hook，以及编译器带来的自动记忆化、减少手动 useMemo/useCallback 等收益。
- 组合模式：涵盖复合组件（父提供 context、子消费 context、基于插槽的灵活组合，如 Tabs、Accordion、Dropdown），并对比 Render Props 与 Hooks 的适用场景，以及高阶组件的跨切面用途。
- 性能原则：给出何时优化的信号（渲染慢先分析、大列表虚拟化、昂贵计算用 useMemo、稳定回调用 useCallback），并规定优化顺序：先确认是否真的慢、用 DevTools 分析、定位瓶颈、再针对性修复。
- 错误处理：说明错误边界的放置范围（应用级放根层、功能级放路由/功能层、组件级放在高风险组件周围），以及错误恢复做法：展示降级 UI、记录错误、提供重试、保留用户数据。
- TypeScript 模式：建议组件 Props 用 interface，联合与复杂类型用 type，可复用组件用泛型；常见类型包括 children 用 ReactNode、事件处理器用 MouseEventHandler、ref 用 RefObject。
- 测试原则：按单元（纯函数、Hook）、集成（组件行为）、E2E（用户流程）分层，测试优先级为用户可见行为、边界情况、错误状态和可访问性。
- 反模式：列出应避免的做法及替代方案，如深层 prop drilling 改用 context、巨型组件拆分、不要用 useEffect 处理一切而考虑服务端组件、避免过早优化、不要用索引作 key 而使用稳定唯一 ID。
三、使用方式 资料本身以原则和对照表呈现，未提供安装命令或代码示例，具体落地方式暂未提供。
四、适用场景 适合 React 项目的架构设计、代码评审、团队规范制定，以及开发者系统梳理现代 React 实践。
五、限制 资料未说明所支持的 React 版本范围、依赖要求、平台限制或收费信息，这些内容暂未提供。