Next.js 专题导览
这里把 Next.js 从一篇总览继续拆成了一组专题。这样更容易按问题去找,也更容易顺着读下去。
Next.js 项目结构
这篇只讲一件事:一个现代 Next.js 项目,目录到底应该怎么理解。
App Router 和 Pages Router 怎么看
很多 Next 文档最容易让人混乱的地方,不是 API,而是两套路由系统并存。
Next.js 路由系统
Next.js 的路由系统不是单纯把文件映射成路径,它还顺带定义了页面层 级、布局继承、加载状态和一部分服务端边界。
Next.js 渲染与数据获取
这一块是 Next.js 最核心的基础之一。很多看起来像“API 记忆题”的东西,背后其实都在回答同一个问题:
Next.js 水合(Hydration)
水合是 Next.js 和 React 里最容易“项目能跑,但脑子里还没完全接上”的一块。
Next.js 缓存与重验证
从 13 开始,缓存已经不是 Next.js 的边角能力了。到了 15 和 16,这一层几乎成了框架心智的核心部分。
Next.js Server Actions
Server Actions 是 App Router 里非常关键的一块能力。它让“写操作”不再一定要先绕到单独接口层,再从客户端手工拼一次请求。
Next.js 鉴权、权限与 Proxy
这块很容易被混成一件事,但实际至少有三层:
Next.js Route Handlers 与 API 设计
在 App Router 里,Route Handlers 基本就是接口层正路。
Next.js Streaming、Suspense 与 Partial Prerendering
这一块最能看出 App Router 和老式 SSR 的差别。
Next.js Metadata、SEO、sitemap 与 robots
如果把 SEO 理解成“改个 title”,放在 Next 项目里通常会太浅。
Next.js 图片、字体与第三方脚本
这块经常被拆成三个零散话题来看:
Next.js 国际化、多语言与路由策略
国际化这件事在 Next.js 里通常分成两层:
Next.js 部署、自托管与 standalone
Next.js 的部署方式不只是“上 Vercel 就行”这么一句话。
Next.js 9 到 16 的版本演进
如果最早接触的是 Next.js 9.0,那现在回头看,变化其实非常大。
Next.js 14、15、16 更新对比
如果只看最近三代,脉络会很清楚:
Next.js 升级检查清单
这篇不按“功能介绍”写,而是按升级时最容易漏掉的点来收。
这组文档适合怎么读
1. 先补基础层
这一组适合从头顺着读,读完之后,Next 的主体结构基本就清楚了:
- 项目结构
- App Router 和 Pages Router 怎么看
- Next.js 路由系统
- 渲染与数据获取
- 水合(Hydration)
- 缓存与重验证
- Server Actions
- 鉴权、权限与 Proxy
这部分读完,再回头看版本变化,理解会顺很多。
2. 再补工程与交付层
这一组更接近真实项目落地,关注接口、渲染边界、SEO、部署和多语言:
- Metadata、SEO、sitemap 与 robots
- 图片、字体与第三方脚本
- 部署、自托管与 standalone
- Route Handlers 与 API 设计
- Streaming、Suspense 与 Partial Prerendering
- 国际化、多语言与路由策略
3. 最后补版本线
如果最早接触的是 9.0 那一代,这一组会更有对照感:
这里会把每个大版本放到同一条时间线上看,重点不在背 release notes,而在看清楚重心怎么一路迁过去。
4. 升级时再看差异和清单
如果当前已经在做升级,直接看这两篇: