该技能用于在 Next.js 15 App Router(app/ 目录)中开发时提供模式参考,涵盖服务端组件与客户端组件、Server Actions、Route Handlers 等场景。
主要能力与用法: 文件约定:app/ 下 layout.tsx 为必需根布局,page.tsx 对应路由页面,loading.tsx 提供 Suspense 加载 UI,error.tsx 为错误边界,not-found.tsx 为 404 页;(auth)/ 为不影响 URL 的路由组,api/route.ts 为 API 处理器,_components/ 为不参与路由的私有目录。 服务端组件:默认即为服务端组件,无需指令,可直接使用 async 函数并 await 数据查询。 Server Actions:在文件顶部写 "use server",可结合 revalidatePath 与 redirect,通过 form action 调用。 数据获取:可用 Promise.all 并行请求,或用 Suspense 配合 fallback 实现流式渲染。 Route Handlers:在 app/api/.../route.ts 中导出 GET、POST 等函数,使用 NextRequest 与 NextResponse 返回 JSON。 中间件:根目录 middleware.ts 中导出 middleware 函数,可读取 cookie 并重定向,通过 config.matcher 限定匹配路径。 元数据:可导出静态 metadata 对象,或用 generateMetadata 动态生成。 server-only:导入 "server-only" 的模块若被客户端组件引用会报错,用于保护服务端数据。
限制:资料未提供版本兼容性、性能数据、收费或平台信息,暂未提供。