React Patterns 是一套面向生产级 React 应用的开发原则与模式集合,用于指导组件设计、状态管理与性能优化等实践。
用途:为 React 项目提供可参考的模式选择依据,覆盖从组件划分到测试的常见决策点。
主要能力:
- 组件设计:区分 Server、Client、展示型与容器型组件,强调单一职责、props 向下事件向上、组合优于继承。
- Hook 模式:给出 useLocalStorage、useDebounce、useFetch、useForm 等自定义 Hook 的抽取时机,并列出 Hook 规则(仅在顶层调用、顺序一致、以 use 开头、卸载时清理副作用)。
- 状态管理选择:按复杂度推荐 useState/useReducer、Context、React Query/SWR、Zustand/Redux Toolkit,并说明状态放置范围。
- React 19 模式:介绍 useActionState、useOptimistic、use 等新 Hook,以及编译器带来的自动记忆化收益。
- 组合模式:复合组件、render props 与 Hook 的取舍、高阶组件适用场景。
- 性能原则:先分析再优化,按需使用虚拟化、useMemo、useCallback。
- 错误处理:错误边界的分层放置与恢复策略。
- TypeScript 与测试:props 类型写法、常用类型,以及单元、集成、E2E 的测试重点。
- 反模式:避免深层 prop drilling、巨型组件、滥用 useEffect、过早优化、用索引作 key。
使用方式:作为开发时的模式参考清单,按具体场景查阅对应章节。资料未提供安装命令或代码示例。
适用场景:React 应用架构设计、代码评审、团队规范制定与学习参考。
限制:资料为原则性说明,未提供具体版本要求、依赖、收费信息或完整示例,实际落地需结合项目情况判断。