用途:在构建 React 应用、优化性能、选择状态管理方案、实现数据获取以及审查组件架构时使用;不适用于非 React 框架、纯服务端渲染且不用 React 的场景,以及无交互的静态站点。
主要能力:以速查表形式给出模式与 API 对照。数据获取用 use(dataPromise) 替代 useEffect+useState;表单处理用 useActionState(action, init),内置 pending 状态与错误处理;乐观 UI 用 useOptimistic(state, updateFn);非紧急更新用 useTransition();副作用事件用 useEffectEvent(fn),在不重新触发副作用的前提下读取最新值;表单 pending 状态用 useFormStatus();唯一 ID 用 useId(),保证水合安全。服务端状态可选 React Query / useSuspenseQuery 做缓存、去重与后台刷新;客户端局部状态用 useState / useRef,跨组件客户端状态用 Zustand / Context;派生状态应在渲染期间计算,不要用副作用同步。惰性初始化用 useState(() => expensive())。组件分为 Page、Feature、UI 三类。记忆化优先信任 React Compiler,仅在必要时手写 useMemo/useCallback。React 19 中 ref 可直接作为函数组件 prop,无需 forwardRef。代码分割用 React.lazy() + Suspense,并行请求用 Promise.all(),请求去重用 React.cache(),可用 cacheSignal() 中止服务端工作,并支持 prefetchDNS、preconnect、preload、preinit 预加载资源,<Activity> 可在隐藏 UI 时保留状态。
使用方式:按速查表选择对应模式,并参照常见错误对照表纠正写法,例如不用 useEffect + useState 取数、不在 state 中存派生值、不用会改数组的 sort、条件渲染用三元而非 &&、不用 Math.random() 生成 ID、不在 React 19 中使用 forwardRef、不在渲染期间修改 props 或 state。
适用场景与限制:适合 React 19+ 项目;资料未提供安装命令、版本依赖、收费信息及具体代码示例,也未说明平台支持范围。