SuperAPI AI 工具集

nextjs-15

前端与建站

查看项目

更新于 10-16 02:36

技能介绍

用途:这是一套面向 Next.js 15 App Router 的开发规则,触发场景为在 app/ 目录下工作、区分服务端与客户端组件、编写 Server Actions、Route Handlers、中间件、元数据或数据获取逻辑时使用。

主要能力:

  1. 文件约定:app/ 下 layout.tsx(根布局,必需)、page.tsx、loading.tsx、error.tsx、not-found.tsx;路由组 (auth) 不影响 URL;api/route.ts 为 API 处理器;_components/ 为私有目录不参与路由。
  2. 服务端组件:默认即为服务端组件,无需指令,可直接使用 async。
  3. Server Actions:文件顶部加 "use server",可结合 revalidatePath 与 redirect,表单通过 action 属性调用。
  4. 数据获取:可用 Promise.all 并行请求,或用 Suspense 配合 fallback 实现流式渲染。
  5. Route Handlers:在 app/api/.../route.ts 中导出 GET、POST 等函数,使用 NextRequest 与 NextResponse。
  6. 中间件:根级 middleware.ts,通过 request.cookies 判断并重定向,config.matcher 限定匹配路径。
  7. 元数据:导出静态 metadata 对象,或用 generateMetadata 动态生成。
  8. server-only 包:在仅服务端模块中导入 "server-only",若被客户端组件引用会报错。

使用方式:将上述规则作为编码约定,在对应文件位置按示例结构编写代码;命令与代码保持原样。

适用场景:使用 Next.js 15 App Router 构建全栈应用、API 与页面路由。

限制:资料未提供版本兼容细节、性能数据、收费信息或具体安装命令,暂未提供。