用途:这是一份 Next.js 15+ App Router 开发规范,用于指导按现代模式编写页面、布局、路由处理器与数据获取逻辑。
主要能力:强调服务端优先架构,默认使用 Server Components,仅在需要事件监听、状态与生命周期、浏览器 API 或自定义 Hook 时使用带 'use client' 的 Client Components。采用基于文件的路由约定,如 layout.tsx、page.tsx、loading.tsx、error.tsx、not-found.tsx 及动态段 [id]。数据获取在 Server Components 中用 async/await 完成,支持 next.revalidate 缓存、Promise.all 并行获取与 Suspense 流式渲染。还涵盖嵌套布局、Route Handlers(app/api 下的 route.ts)、Server Actions('use server' 配合 revalidatePath、redirect)、Link 与 useRouter 导航、静态与动态 metadata、错误处理、generateStaticParams 与 ISR。
使用方式:按资料中的文件结构组织 app 目录,页面组件默认导出 async 函数;需要交互的组件加 'use client';表单可直接 action={createPost} 调用 Server Action;接口用 GET/POST 等导出函数返回 NextResponse.json。
适用场景:使用 App Router 构建的 Next.js 15+ 项目,尤其是需要服务端渲染、静态生成、增量再验证与表单提交的场景。
限制:资料未提供安装命令、版本兼容细节、性能基准或收费信息;示例中的数据库与 API 函数为示意,需自行实现。