Agent Skills
返回列表
💻

React 生产级模式

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/react-patterns-zh。

技能介绍

你在纠结什么

React 项目一旦跨过 demo 阶段,常见问题会堆在一起:组件边界划不清、状态该放本地还是全局、useEffect 越写越多、列表一慢就盲目加 useMemo。团队如果没有一套可复述的约定,review 时只能凭个人经验争论。

技能在讲什么

本技能把 生产级 React 拆成可对照的决策表与规则,而不是 API 教程:

  • 组件设计:区分服务端/客户端、展示/容器组件;强调单一职责、props 下传事件上抛、组合优于继承。
  • Hooks:说明何时抽 useLocalStorage、useDebounce、useFetch、useForm;强调顶层调用、卸载清理。
  • 状态管理:按复杂度映射到 useState/useReducer、Context、React Query/SWR、Zustand/Redux Toolkit,并给出「状态放哪」的作用域表。
  • React 19:useActionState、useOptimistic、use 及编译器对记忆化的影响。
  • 组合与性能:复合组件、Render Props vs Hooks;优化顺序是「先证明慢 → DevTools → 再针对性改」。
  • 工程配套:Error Boundary 分层、TypeScript props 模式、测试优先级,以及深度 props、巨型组件等 反模式 对照表。

适用边界

它是 原则与选型清单,不替代具体项目的架构文档,也不包含某一家 UI 库或框架的完整最佳实践。Server Components 相关能力需结合你实际使用的 Next.js 等版本自行核对。

使用场景

  • 多个列表页重复相同的请求与 loading 逻辑,需要对照清单决定抽自定义 Hook 还是上 React Query/SWR
  • 路由级功能即将上线,要按应用/路由/组件三层规划 Error Boundary 与备选 UI、重试策略
  • Code Review 出现 props 连传五层以上的表单或表格,需用反模式表判断改 Context 还是拆展示/容器组件
  • 用户反馈某页滚动卡顿,团队约定先 DevTools 定位瓶颈,再决定是否列表虚拟化或 useMemo

适合人员

  • 维护 Next.js 业务应用、要在 Server/Client 组件边界上减少多余 useEffect 的全栈前端
  • 负责组件库或设计系统、需统一 Props 的 Interface/Generic 与事件类型的 TypeScript 维护者
  • 带三人以上前端小组、要把状态放置规则与 Hook 命名约定写进 README 的技术负责人
  • 从 class 或 Vue 转 React、需要快速建立组合模式与性能优化顺序认知的上手工程师