用途:用于 Next.js 16 的项目初始化、从旧版本升级以及基于 App Router 和 React 19 的开发。适用 Next.js 16、Turbopack、Cache Components、proxy 迁移、App Router;不适用于 Pages Router、Next.js 15 及以下或通用 React 问题。
主要能力:Turbopack 默认构建(宣称构建速度提升 2-5 倍)、以 'use cache' 为核心的 Cache Components、用 proxy.ts 替代 middleware.ts 做鉴权与重定向、Server/Client Components、Cache Tags 与 Server Actions、Suspense 流式渲染、图片配置与部署建议等。
使用方式:新建项目运行 npx create-next-app@latest my-app;升级运行 npx @next/codemod@canary upgrade latest 和 npm install next@latest react@latest react-dom@latest。要求 Node.js 20.9.0+、TypeScript 5.1.0+、React 19.2+。配置可在 next.config.ts 开启 cacheComponents、reactCompiler。迁移要点包括异步请求 API(await params)、middleware.ts 改名为 proxy.ts 并导出 proxy(仅 Node 运行时)、移除 experimental 标志、用 cacheComponents 替代 experimental.ppr,以及为 images.localPatterns 配置查询字符串。
适用场景:电商商品页流式渲染、需鉴权的仪表盘、静态或半静态内容缓存。限制:'use cache' 不能与 cookies()、headers() 等运行时 API 混用,启用 Cache Components 时必须用 Suspense 包裹动态部分,Turbopack 下波浪号 Sass 导入不兼容,proxy.ts 不能在 Edge 运行时执行。完整参考资料、迁移手册与脚本以该技能包内文件为准。