SuperAPI AI 工具集

nextjs-developer

编程与开发

查看项目

更新于 10-16 23:59

技能介绍

用途

nextjs-developer 是一项面向 Next.js 14+ 的应用开发技能,定位为资深 Next.js 开发者,聚焦 App Router、服务端组件与全栈部署,强调性能与 SEO 优秀。

主要能力与工作流

技能将开发过程分为五个阶段:

  1. 架构规划:定义应用结构、路由、布局与渲染策略。
  2. 实现路由:创建 App Router 结构,包含布局、模板、loading 与 error 状态。
  3. 数据层:设置服务端组件、数据获取、缓存与重验证。
  4. 优化:图片、字体、打包体积、流式渲染与边缘运行时。
  5. 部署:生产构建、环境设置与监控。部署前需验证:本地运行 next build、确认零类型错误、检查 NEXT_PUBLIC_* 与服务端专用环境变量是否已设置、运行 Lighthouse/PageSpeed 确认 Core Web Vitals 大于 90。

使用方式

技能附带分主题的参考文档,可根据上下文加载:

主题 参考文档 加载时机
App Router references/app-router.md 基于文件的路由、布局、模板、路由组
服务端组件 references/server-components.md RSC 模式、流式渲染、客户端边界
服务端操作 references/server-actions.md 表单处理、数据变更、重验证
数据获取 references/data-fetching.md fetch、缓存、ISR、按需重验证
部署 references/deployment.md Vercel、自托管、Docker、优化

实现 Next.js 功能时,技能建议提供以下输出:应用结构(路由组织)、带正确数据获取的布局/页面组件、如需要数据变更则提供服务端操作、配置(next.config.js、TypeScript),以及对所选渲染策略的简要说明。

约束规则

必须做(Next.js 专属):

  • 使用 App Router(app/ 目录),绝不使用 Pages Router(pages/)。
  • 组件默认保持为服务端组件;仅在需要交互的叶子边界添加 'use client'。
  • 使用原生 fetch 并显式指定 cache / next.revalidate 选项,不依赖隐式缓存。
  • 所有 SEO 使用 generateMetadata(或静态 metadata 导出),绝不在 JSX 中硬编码 <title> 或 <meta> 标签。
  • 所有图片用 next/image 优化;内容图片绝不使用普通 <img> 标签。
  • 在每个执行异步数据获取的路由段添加 loading.tsx 和 error.tsx。

绝不要做:

  • 仅为访问数据而把组件转成客户端组件,应先服务端获取。
  • 在异步路由段跳过 loading.tsx/error.tsx 边界。
  • 未运行 next build 确认零错误就部署。

代码示例

带数据获取与缓存的服务端组件

// app/products/page.tsx
import { Suspense } from 'react'

async function ProductList() {
  // Revalidate every 60 seconds (ISR)
  const res = await fetch('https://api.example.com/products', {
    next: { revalidate: 60 },
  })
  if (!res.ok) throw new Error('Failed to fetch products')
  const products: Product[] = await res.json()

  return (
    <ul>
      {products.map((p) => (
        <li key={p.id}>{p.name}</li>
      ))}
    </ul>
  )
}

export default function Page() {
  return (
    <Suspense fallback={<p>Loading…</p>}>
      <ProductList />
    </Suspense>
  )
}

带表单处理与重验证的服务端操作

// app/products/actions.ts
'use server'

import { revalidatePath } from 'next/cache'

export async function createProduct(formData: FormData) {
  const name = formData.get('name') as string
  await db.product.create({ data: { name } })
  revalidatePath('/products')
}

// app/products/new/page.tsx
import { createProduct } from '../actions'

export default function NewProductPage() {
  return (
    <form action={createProduct}>
      <input name="name" placeholder="Product name" required />
      <button type="submit">Create</button>
    </form>
  )
}

用于动态 SEO 的 generateMetadata

// app/products/[id]/page.tsx
import type { Metadata } from 'next'

export async function generateMetadata(
  { params }: { params: { id: string } }
): Promise<Metadata> {
  const product = await fetchProduct(params.id)
  return {
    title: product.name,
    description: product.description,
    openGraph: { title: product.name, images: [product.imageUrl] },
  }
}

知识范围

Next.js 14+、App Router、React 服务端组件、服务端操作、流式 SSR、部分预渲染、next/image、next/font、Metadata API、路由处理器(Route Handlers)、中间件(Middleware)、边缘运行时、Turbopack、Vercel 部署。

适用场景

适合构建使用 App Router 的 Next.js 14+ 全栈应用,包括需要服务端渲染、流式渲染、SEO 优化与 Vercel 部署的项目。

限制

资料未提供具体的安装命令、收费与价格信息,也未说明支持的平台细节;相关内容暂未提供。技能本身包含的约束(如必须使用 App Router、默认服务端组件等)属于使用规范,而非平台限制。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明