Next.js:一个项目同时写好前端页面和后端接口

基于 React 的全栈 Web 框架:页面、接口、渲染与部署优化一站搞定

前端 / 全栈 Web 框架14.4 万
Next.js
协议
MIT
Star 数
约 14.4 万(143,601)
最新版本
v16.4.6(2026-11-09 发布)
运行环境
Node.js 20.9 及以上;基于 React 19

Star 数、版本等数据截至 2026 年 11 月。 技术栈:TypeScriptReactNode.jsTurbopack

定位

一句话:基于 React 的全栈 Web 框架:页面、接口、渲染与部署优化一站搞定

React 只管"界面怎么画",路由、取数据、服务端渲染、打包优化都要自己拼。Next.js 把这些都定好了:app/ 文件夹里的目录结构就是网站的路由,组件默认在服务器上渲染、可以直接 async/await 读数据库或调接口,同一个项目里还能用 route.ts 写后端接口。一个页面里哪些部分提前生成成静态 HTML、哪些部分按请求实时渲染,可以细到组件级别来决定,所以既能做内容站,也能做复杂的 Web 应用。

仓库链接

适用场景

  • 适合:电商与品牌官网(既要首屏快、又要利于搜索引擎收录)、SaaS 产品与后台、AI 聊天类应用、需要前后端放在一个仓库里的中小团队项目。
  • 也能做:完全静态导出部署到任意静态托管;用 Server Actions 直接在组件里处理表单提交;配合 Vercel 官方模板快速搭出电商、聊天机器人、博客。
  • 不太适合:纯内容、几乎没有交互的文档站或博客(Astro 更轻);不用 React 的团队(Nuxt、SvelteKit 是对应的选择);只需要一个纯前端单页应用、没有服务端的项目(直接用 Vite + React 更简单)。

上手示例

用官方脚手架建项目(会自动装好 TypeScript、Tailwind CSS 和 ESLint):

Bash
npx create-next-app@latest my-app --yes
cd my-app
npm run dev

把 app/page.tsx 换成下面的内容,再新建 app/api/hello/route.ts:

TSX
// app/page.tsx:页面默认在服务器上渲染,组件可以直接 async/await
import { Suspense } from "react";
import { connection } from "next/server";

async function ServerTime() {
  await connection(); // 这一块每次访问都在服务器上重新生成
  return <p>服务器时间:{new Date().toLocaleString("zh-CN", { timeZone: "Asia/Shanghai" })}</p>;
}

export default function Home() {
  return (
    <main style={{ padding: 48, fontFamily: "sans-serif" }}>
      <h1>你好,Next.js</h1>
      <Suspense fallback={<p>加载中…</p>}>
        <ServerTime />
      </Suspense>
      <a href="/api/hello">访问接口 /api/hello</a>
    </main>
  );
}
TypeScript
// app/api/hello/route.ts:同一个项目里直接写后端接口
export function GET() {
  return Response.json({ message: "你好,Next.js", time: new Date().toISOString() });
}

打开 http://localhost:3000 能看到标题和服务器时间,点链接会返回一段 JSON。标题部分在构建时就生成好了,<Suspense> 里的服务器时间则是每次访问时在服务器上实时渲染再流式送到浏览器——这就是 Next.js 16 默认的"部分预渲染"。运行 npm run build 时,终端会把首页标成 ◐(静态外壳 + 动态内容)、把 /api/hello 标成 ƒ(按请求运行)。

优点

  • 前后端一个项目:页面、接口、表单处理(Server Actions)写在一起,类型从数据库一路贯通到界面,小团队也能独立做完整产品。
  • 渲染方式灵活:静态生成、服务端渲染、按请求流式渲染可以在同一个页面里按组件混用,兼顾首屏速度和数据实时性。
  • 开箱即有的优化:图片、字体、脚本的优化组件,按路由自动拆包,默认用 Turbopack 打包,开发时热更新快。
  • 生态与资料最丰富:React 官方文档推荐的框架之一,模板、教程、第三方集成(认证、CMS、支付)都很多;MIT 协议,可自行部署到任何支持 Node.js 的服务器或用 Docker 部署。

缺点

  • 概念多、学习曲线陡:服务端组件与客户端组件的边界("use client")、缓存规则、部分预渲染都要理解;比如上面的示例里,直接在页面里读当前时间而不包 <Suspense>,构建会直接报错。
  • 大版本变化快:从 Pages Router 到 App Router、再到 v16 的 Cache Components,写法每一两年就有较大变化,老项目升级要照官方迁移指南逐步改。
  • 部署到 Vercel 最省心:自己部署也完全可以,但增量渲染、图片优化等功能在自建服务器上要多做一些配置。
  • 对简单站点偏重:纯展示的小站用它,依赖和构建产物都比 Astro 这类内容框架大。

同类对比

框架更适合
Remix / React Router同样基于 React,更贴近 Web 标准(表单、请求),适合偏数据表单的应用
NuxtVue 生态里对应的全栈框架
Astro以内容为主、交互很少的网站,默认几乎不发 JavaScript

延伸阅读

作品展示

官方作品展示页按"电商""Web 应用""AI""营销与媒体""平台工程"分类,收录了 Nike、OpenAI、Netflix 等大公司的网站。下面挑两个官方模板的在线演示和三个知名网站。