用途:用于创建 Web 应用、选择前端技术栈、组织组件结构、实现 UI/UX 设计,并优化性能。采用服务端优先架构,不适用于后端 API 设计、数据库 schema 或部署基础设施。
主要能力与默认做法:框架默认 Next.js App Router,单页应用可选 React + Vite。组件分为 Page、Feature、UI、Layout 类型,强调单一职责、类型化 props 与组合。默认使用 Server Components,仅在叶子节点按需添加 'use client'。局部状态用 useState 并尽量靠近使用位置,全局状态用 Context API(主题、认证)或 Zustand(复杂场景)。数据获取在服务端用 Server Components,客户端用 TanStack Query;变更用 Server Actions,缓存用 revalidatePath。表单用 React Hook Form + Zod,或 Server Actions + useActionState,配合乐观更新 useOptimistic。样式采用 Tailwind CSS v4 + shadcn/ui,使用 @theme 进行 CSS 优先配置。性能方面使用 Suspense 流式渲染、React.lazy()、next/dynamic 与按需 memo();用错误边界和每路由 error.tsx 包裹功能区块。
常见误区:不要给每个组件加 'use client';避免巨型组件;状态别全放组件树顶部;派生数据用 useMemo 而非 useEffect;简单变更别建 API 路由;跨服务端/客户端边界的 props 必须可序列化;Tailwind v4 不要用 tailwind.config.js;能用 Server Components 就别在客户端取数。
协作:可将 React 模式、Next.js、TanStack Query、TanStack Form、Tailwind、设计系统、性能优化等交给对应专项技能处理。资料未提供安装命令、定价与具体平台信息。