结论先行:Next.js 16 已于 2025 年 10 月 21 日正式发布,Turbopack 成为开发与生产构建的默认打包器,官方口径是生产构建提速 2-5 倍、Fast Refresh 最高提速 10 倍。同时引入 Cache Components 显式缓存模型、proxy.ts 网络边界与 Devtools MCP。存量项目升级的重点不在新特性,而在异步 params、revalidateTag 签名等破坏性变更,建议先跑官方 codemod 再人工核对。
一、这次发布到底改了什么
Next.js 团队在 Next.js Conf 2025(10 月 22 日)前一天推送了 16 正式版。相比 15.x,这一版的主线有三条:构建工具链全面切换到 Rust 编写的 Turbopack;缓存从「框架隐式决定」转向「开发者显式声明」;开发调试开始原生对接 AI 代理。官方披露,在 15.3+ 版本上已有超过一半的开发会话和两成生产构建提前用上了 Turbopack,默认化只是把既成事实写进配置。
对日常开发最直观的变化是等待时间:大项目的冷启动、热更新和 CI 构建都会明显缩短,而且不需要改任何配置。如果你的项目还停留在自定义 webpack loader 上,官方保留了 next dev --webpack 与 next build --webpack 的回退通道,但这条通道长期看会逐步边缘化。
二、Turbopack 默认化:数据与配置
| 指标 | 官方口径 |
|---|---|
| 生产构建 | 比 webpack 快 2-5 倍 |
| Fast Refresh | 最高快 10 倍 |
| 采用率(15.3+) | 开发会话超 50%,生产构建约 20% |
大型仓库还可以开启文件系统缓存(Beta),把编译产物持久化到磁盘,重启开发服务器时不再从零编译:
// next.config.ts
const nextConfig = {
experimental: {
turbopackFileSystemCacheForDev: true,
},
};
export default nextConfig;注意 turbopack 配置项已从 experimental 提升到顶层;如果项目里存在 Babel 配置,Turbopack 现在会自动启用 Babel 而不是直接报错,这会让构建变慢,建议顺手清理历史遗留的 .babelrc。
三、Cache Components:缓存从隐式到显式
过去 App Router 的缓存行为常被吐槽「猜不透」:一个页面到底静态还是动态,取决于框架对代码的静态分析。16 给出的答案是 Cache Components——默认所有动态代码都在请求时执行,想缓存就用 use cache 指令显式声明,缓存键由编译器自动生成:
// next.config.ts 开启
const nextConfig = { cacheComponents: true };async function ProductList() {
'use cache';
const goods = await fetchGoods();
return <ul>{goods.map((g) => <li key={g.id}>{g.name}</li>)}</ul>;
}它同时补完了 PPR(部分预渲染)的故事:静态外壳保证首屏速度,动态孔洞通过 Suspense 流式输出。旧的 experimental.ppr、experimental.dynamicIO 标志已移除,统一收敛到 cacheComponents。
缓存失效 API 也细分为三个,按一致性需求选用:
| API | 语义 | 适用场景 |
|---|---|---|
| revalidateTag(tag, profile) | 失效后后台重验证(SWR) | 可容忍短暂陈旧的内容 |
| updateTag(tag) | 失效并立即读新数据 | 表单提交后立刻看到结果 |
| refresh() | 只刷新未缓存数据 | 通知数、状态徽标等 |
其中 revalidateTag 现在要求第二个参数传 cacheLife 配置(多数场景官方推荐 'max'),单参数写法已弃用,这是升级时最容易漏改的一处。
四、proxy.ts 与路由预取重写
middleware.ts 更名为 proxy.ts,导出函数同步改名,逻辑不变,运行在 Node.js 运行时。官方解释是「中间件」这个名字承载了太多歧义,proxy 更准确地表达了网络边界的职责。旧文件名仍可用但已弃用,Edge 场景除外。
路由预取则做了整体重写:共享布局去重(50 个商品链接只下载一次布局而不是 50 次)、增量预取(只取缓存中缺失的部分)、链接离开视口即取消请求。代价是请求数变多、单个体积变小,官方认为这对绝大多数应用是划算的交换。这些优化无需改代码即可生效。
五、破坏性变更清单
| 变更 | 说明 |
|---|---|
| Node.js 20.9+ | 不再支持 Node 18 |
| TypeScript 5.1+ | 最低版本要求提升 |
| params / searchParams | 必须 await,同步访问报错 |
| cookies() / headers() | 同样必须异步访问 |
| AMP、next lint | 彻底移除,lint 改用 ESLint/Biome |
| next/image 默认值 | minimumCacheTTL 改为 4 小时,qualities 收敛为 [75] |
| 并行路由 | 每个 slot 必须显式提供 default.js |
| serverRuntimeConfig | 移除,改用环境变量 |
浏览器基线同步提高到 Chrome/Edge/Firefox 111+、Safari 16.4+,需要兼容更旧环境的项目要提前评估。React 侧则跟进到 19.2,带来 View Transitions、useEffectEvent 与 Activity 组件;React Compiler 支持转为稳定,但默认不开启,需手动配置 reactCompiler: true 并安装 babel-plugin-react-compiler。
六、升级步骤建议
# 自动升级(含 codemod)
npx @next/codemod@canary upgrade latest
# 或手动升级
npm install next@latest react@latest react-dom@latestcodemod 能处理大部分机械改动,但缓存语义、image 配置和并行路由需要人工核对。建议先升 Node 与 TS,再跑 codemod,重点回归「提交后立即展示」的交互路径(对应 updateTag 迁移)与图片加载行为,最后观察构建日志里各阶段耗时,确认 Turbopack 收益落袋。
七、AI 调试与数据层:顺手补齐的两块
16 新增的 Devtools MCP 把路由、缓存、日志与错误堆栈开放给 AI 代理,调试从「复制报错给模型」变成「模型直接读应用上下文」。如果你在用 Cursor、Claude、Trae 或 Qoder 这类工具写 Next.js,可以把「api工厂」的官方 MCP 也一并接入:它兼容上述主流 AI 编程工具,能让代理直接查询和调用平台的用户、商品、订单、CMS 等开放接口,写页面时不用再手动翻接口文档。入口见 https://www.it120.cc/ai.html 。
数据层同理:Next.js 负责渲染与缓存,业务数据可以直接来自现成的后端服务。api工厂提供全开放前后台接口与 apifm-webapi 等六端 SDK,统一返回 {code,data,msg},在 Server Component 里 fetch 一次就能渲染商品列表,配合 use cache 做显式缓存,个人项目和小团队可以完全跳过自建后端。SDK 文档:https://www.it120.cc/sdk/index.html 。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。