Skip to content

Next.js 速查表

生产级 React 框架——支持 SSR、SSG、ISR 与 API 路由。

01

快速上手

页面

App Router 在 app/ 目录下使用文件路由。

nextjs
// app/page.tsx
export default function Home() {
  return <h1>Hello</h1>;
}

布局

布局包裹页面,并在导航间保持持久。

nextjs
// app/layout.tsx
export default function Layout({ children }) {
  return <html><body>{children}</body></html>;
}

数据获取

服务端组件可直接获取数据。

nextjs
async function getData() {
  const res = await fetch("https://api.example.com");
  return res.json();
}

export default async function Page() {
  const data = await getData();
  return <div>{data.name}</div>;
}
02

核心特性

动态路由

用 [slug] 表示动态段。

nextjs
// app/blog/[slug]/page.tsx
export default function Page({ params }) {
  return <h1>{params.slug}</h1>;
}

API 路由

用路由处理器实现 API 端点。

nextjs
// app/api/route.ts
export async function GET() {
  return Response.json({ ok: true });
}

客户端组件

用 'use client' 启用客户端交互。

nextjs
"use client";
import { useState } from "react";

export default function Counter() {
  const [n, setN] = useState(0);
  return <button onClick={() => setN(n+1)}>{n}</button>;
}

中间件

中间件在路由完成前运行。

nextjs
// middleware.ts
export function middleware(req) {
  if (!req.cookies.get("auth")) {
    return NextResponse.redirect("/login");
  }
}

这篇内容对您有帮助吗?