SuperAPI AI 工具集

next-upgrade

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:将当前项目升级到最新 Next.js 版本,依据官方迁移指南与 codemod 完成破坏性变更处理。

主要能力与用法:

  1. 检测当前版本:读取 package.json,确认现有 Next.js 版本及 React、React DOM 等相关依赖。
  2. 获取最新升级指南:通过 WebFetch 读取官方文档,包括 codemods 页面(https://nextjs.org/docs/app/building-your-application/upgrading/codemods)及按版本区分的指南(如 version-15、version-14,按需调整版本号)。
  3. 确定升级路径:根据当前版本判断适用哪些迁移步骤;跨大版本时逐步升级(如 13 → 14 → 15)。
  4. 优先运行 codemod:命令为 npx @next/codemod@latest <transform> <path>。常见 transform 包括 next-async-request-api(更新异步 Request API,v15)、next-request-geo-ip(迁移 geo/ip 属性,v15)、next-dynamic-access-named-export(转换动态导入,v15)。
  5. 更新依赖:npm install next@latest react@latest react-dom@latest;如使用 TypeScript,再执行 npm install @types/react@latest @types/react-dom@latest。
  6. 审查破坏性变更:查阅升级指南确认需手动修改的部分,如 API 变更(v15 的异步 params)、next.config.js 配置变更、被移除的废弃功能。
  7. 测试:运行 npm run build 检查构建错误,运行 npm run dev 验证关键功能。

适用场景:需要将既有 Next.js 项目升级到新版本、批量应用官方破坏性变更迁移的开发者。

限制:资料未提供具体的支持版本区间、自动化程度上限、回滚方式及与特定部署平台的兼容性说明;升级过程仍需人工审查与测试,codemod 覆盖范围以官方文档为准。