Next.js & React 现代架构指南 (React Next.js Architect)
在设计或编写 Next.js (App Router) / React 19 应用时,遵循以下架构准则。
核心架构原则
服务端优先(Server Components by Default):
- 默认所有组件均为 Server Components(无需导入到客户端 JS Bundle)。
- 仅在需要
useState、useEffect、onClick等交互时在最顶层添加'use client'。
数据获取与缓存:
- 在 Server Component 中直接进行
async/await异步数据请求,避免在客户端useEffect瀑布流拉取。
- 在 Server Component 中直接进行
自动化检查脚本
node scripts/audit_nextjs_components.mjs <项目源码目录>