用途:在需要将 Next.js 项目升级到新主版本(例如 v14 到 v15)时使用,提供自动化与手动迁移步骤。
主要能力与流程:先检查 package.json 中 next、react、react-dom 的版本;规划增量升级路径(如 v13 -> v14 -> v15,不跳过主版本)。运行 codemod:npx @next/codemod@latest <transform> <path>,并更新依赖。验证异步 API,确保 cookies()、headers()、params 已 await(v15+)。审计 fetch 缓存,v15 默认 no-store,需要时添加 force-cache。运行 next build,修复 hydration 或 Turbopack 错误,并向团队报告 codemod 失败或手动修复项。
实施要点:升级检测始终查看 package.json;大幅跳跃须逐主版本增量升级并遵循官方迁移指南;先跑 codemod 再处理破坏性变更;react 与 react-dom 需匹配 Next.js 的 peer 依赖(如 Next.js 15 配 React 19);每步增量后运行 next dev 与 next build,检查控制台 hydration 警告。
限制与反模式:不得跳过主版本;不要先手动修复破坏性变更,应优先使用 codemod;升级后不可假设缓存行为不变;Pages Router 中不要使用 async page 函数(export default async function Page() 会致命)。官方文本、收费与平台信息暂未提供。