用途:这是一套面向 Next.js 15 App Router 的开发规则,触发场景为在 app/ 目录下工作、区分服务端与客户端组件、编写 Server Actions、Route Handlers、中间件、元数据或数据获取逻辑时使用。
主要能力:
- 文件约定:app/ 下 layout.tsx(根布局,必需)、page.tsx、loading.tsx、error.tsx、not-found.tsx;路由组 (auth) 不影响 URL;api/route.ts 为 API 处理器;_components/ 为私有目录不参与路由。
- 服务端组件:默认即为服务端组件,无需指令,可直接使用 async。
- Server Actions:文件顶部加 "use server",可结合 revalidatePath 与 redirect,表单通过 action 属性调用。
- 数据获取:可用 Promise.all 并行请求,或用 Suspense 配合 fallback 实现流式渲染。
- Route Handlers:在 app/api/.../route.ts 中导出 GET、POST 等函数,使用 NextRequest 与 NextResponse。
- 中间件:根级 middleware.ts,通过 request.cookies 判断并重定向,config.matcher 限定匹配路径。
- 元数据:导出静态 metadata 对象,或用 generateMetadata 动态生成。
- server-only 包:在仅服务端模块中导入 "server-only",若被客户端组件引用会报错。
使用方式:将上述规则作为编码约定,在对应文件位置按示例结构编写代码;命令与代码保持原样。
适用场景:使用 Next.js 15 App Router 构建全栈应用、API 与页面路由。
限制:资料未提供版本兼容细节、性能数据、收费信息或具体安装命令,暂未提供。