用途:面向生产级 React 19 应用的组件与组合层开发指南,聚焦组件设计、Hooks、状态管理、组件内错误处理与测试策略。涉及 React Router 数据模式、TypeScript 严格性、构建工具、组件 API 设计、表单 UX、无障碍及 CSS 响应式时,分别参考 /react-router、/typescript、/ux-design、/css-responsive。
主要能力:讲解 React 19 的 use() 钩子(可在条件与循环中读取 Promise 和 context,未完成前挂起);自定义 Hook 的抽取时机(逻辑在 2 个以上组件共享、状态管理复杂、需独立于 UI 测试时抽取),命名规范(必须 use 前缀,名称描述提供什么而非如何,3 个以上返回值用对象、1—2 个用元组),由简单 Hook 组合复杂 Hook;用 Testing Library 的 renderHook 与 act 测试 Hook,需要 Provider 时传入 wrapper。错误处理部分介绍用 react-error-boundary 的 ErrorBoundary 做功能隔离,并指出其无法捕获事件处理器、React 渲染外的异步以及边界自身错误;非阻塞错误可用 sonner、react-hot-toast 等 Toast,但不得作为校验反馈的唯一错误提示。状态管理给出位置决策框架:瞬态 UI 用 useState,派生值用 useMemo,表单数据用非受控输入,共享 UI 用 Context + useState。
使用方式与限制:文档以代码示例与对照表格形式呈现,未提供安装命令或运行步骤。文中列出反模式及修复方式,如超过 4 层 prop drilling、无 SSR 保护的 useLayoutEffect、用 useEffect 同步派生值、到处手动 memo、用 useState 存表单字段值等。资料未说明收费、价格、支持平台或实际效果,这些事实暂未提供。