跳到主要内容

Next.js 笔记 · 总览

Next.js 是基于 React 的全栈应用框架,由 Vercel 维护。 笔记默认基于 Next.js 14+ App Router 体系。

配套 demo​

目录结构​


一、Next.js 是什么​

一句话:Next.js 是 React 的"上半身",把构建 React 应用所需的大部分工程决策(路由、构建、数据获取、部署、SSR/SSG、图片优化等)内置到框架里,让你写"项目"而不是拼凑一堆工具。

它不是一个新框架替代 React,而是 React 的元框架(meta-framework):

  • 下层仍是 React(写组件、写 hooks 的方式不变)
  • 上层补齐了路由、SSR、构建、部署等所有"做完整应用"必备的能力

二、Next.js 相对 React SPA 的核心差异​

很多人熟悉的是 create-react-app / Vite + React Router 这种**单页应用(SPA)**模式。Next.js 的关键差异如下。

1. 路由方式​

维度传统 SPANext.js App Router
路由声明在代码里写 <Route path="..."> 路由表把 page.tsx 文件放到对应文件夹,文件即路由
路由表维护手动维护,容易漏天然零成本,新文件自动成路由
嵌套布局需要第三方库或自己写原生 layout.tsx,按目录层级自动嵌套
嵌套加载状态自己写原生 loading.tsx,自动 Suspense 包裹
错误边界自己写原生 error.tsx

2. 渲染模型(最根本的差异)​

模式传统 SPANext.js
默认渲染位置浏览器(CSR)服务端(Server Component 默认)
首屏 HTML几乎是空壳 + 巨型 JS bundle服务端就生成好完整 HTML
SEO通常较差(爬虫跑不动 JS 时)友好(直接拿到完整内容)
首屏速度受网络+JS 解析拖累更快(HTML 直出,JS 后到)
交互路由切换快同上(App Router 切换时只下载该路由的 RSC payload)

3. 组件的两种形态​

Next.js 13+ 引入 React Server Components (RSC) 后,组件分为:

  • Server Component(默认):在服务端渲染,可以直接 await fetch、读数据库,但不能有 useState / useEffect / 事件处理
  • Client Component:在文件顶部加 "use client",能用所有 React hooks、能交互

这一划分是 SPA 完全不需要考虑的——SPA 里所有组件都在浏览器跑。

4. 数据获取​

  • 传统 SPA:组件 useEffect 里发请求,有瀑布流问题
  • Next.js:Server Component 里直接 await fetch,可以并行,可以缓存,可以在数据就绪前不渲染组件(消除瀑布流)

5. 变更与服务端写入​

  • 传统 SPA:前端调 REST / GraphQL 接口,后端另外写
  • Next.js:可以写 Server Action —— 一个普通函数直接当 <form action> 用,不需要单独写 API 路由

6. 资源优化内置​

Next.js 默认帮你做了一堆优化,不用自己接:

  • <Image>:自动懒加载、响应式、WebP 转换、CLS 防护
  • <Link>:客户端导航、预取可见链接
  • next/font:本地托管字体、零 CLS
  • next/script:脚本加载策略

7. 工程一体化​

能力传统 SPA 自配Next.js
构建工具自己选 Vite / Webpack内置(Webpack / Turbopack)
TypeScript手动配开箱即用
CSS Modules手动配内置
Tailwind手动配一键集成
ESLint手动配内置
部署自己处理next start,Vercel 一键部署

三、什么时候用 Next.js、什么时候用纯 SPA​

适合 Next.js​

  • 有 SEO / 分享 / 首屏速度要求的内容站、电商、博客、文档站
  • 后端能力也想用 JS 一把梭(BFF 场景)
  • 希望框架帮你做对的事(路由、缓存、图片优化别自己折腾)

适合纯 SPA​

  • 后台管理系统、纯内部工具(不需要 SEO、不在乎首屏)
  • 应用逻辑极重、内容极轻(编辑器、设计工具、IDE 类)
  • 团队已经重度投资在别的方案上

不是二选一​

Next.js 也可以在特定路由下用 "use client" 退化成纯 SPA 风格,反过来用 Vite + React 也能做 SSR(但要自己接 SSR 框架,如 Remix 或自己用 React 18 streaming)。只是默认选择上,面向用户的内容型项目,Next.js 是当前最省心的选择。


四、Next.js 核心特性速览​

按"用得上频率"排:

特性用途详见
App Router文件式路由 + 嵌套布局 + loading/errorII_Next.js 路由笔记
Server Components默认在服务端渲染、减少 JS 体积III_Next.js Server与Client组件笔记
Client Components交互组件用 "use client" 标记III_Next.js Server与Client组件笔记
Server-side Fetchawait fetch() 在 Server ComponentIV_Next.js 数据获取与Server Actions笔记
Server Actions服务端函数直接当 <form action>IV_Next.js 数据获取与Server Actions笔记
渲染模式SSR / SSG / ISR / Streaming / PPRV_Next.js 渲染模式笔记
Image / Link / Font资源优化内置组件VI_Next.js 常见问题笔记
Middleware在请求到达页面之前跑代码VI_Next.js 常见问题笔记
Route Handlers写 API 端点(route.ts)IV_Next.js 数据获取与Server Actions笔记

五、版本与术语速记​

  • Pages Router:旧版路由系统(13 之前唯一选择),基于 pages/ 目录
  • App Router:13+ 引入、13.4 稳定的新路由系统,基于 app/ 目录,本笔记默认讲这个
  • RSC (React Server Components):服务端组件,与 App Router 配合,是 Next.js 13+ 最大的架构变化
  • Turbopack:Next.js 13+ 引入的新构建工具(Webpack 替代品),开发模式下启动更快
  • PPR (Partial Prerendering):Next.js 14 引入的实验性特性,把页面分成"静态外壳 + 动态洞"

六、第一个 Next.js 项目(最快 5 分钟起步)​

# 不用 create-next-app 也能用,最小结构就是 app/ 目录里写个 page.tsx
npx create-next-app@latest my-app
# 选项都默认即可:TypeScript / App Router / Tailwind 可选

cd my-app
npm run dev
# 打开 http://localhost:3000

最小可运行的 app/page.tsx:

export default function Home() {
return <h1>Hello Next.js</h1>
}

没有任何 useState、没有任何 "use client",这就是一个纯 Server Component,比 SPA 写法还短。


七、学习路径建议​

  1. 先看路由:弄懂 app/page.tsx、layout.tsx、loading.tsx、error.tsx 的作用
  2. 再切 Client:找一处需要交互的地方,加 "use client",感受边界
  3. 再学数据获取:把 useEffect(fetch) 改成 await fetch,对比差别
  4. 再学 Server Actions:把表单提交从"前端 fetch + 后端 API"改成 <form action={serverAction}>
  5. 最后学渲染模式:理解每个路由的"静态 / 动态"对缓存与性能的影响