用途:将当前项目按官方迁移指南升级到最新 Next.js 版本。
主要能力与用法:先读取 package.json 识别当前 Next.js 版本及相关依赖(React、React DOM 等);再用 WebFetch 获取官方升级文档,包括 codemods 页面 https://nextjs.org/docs/app/guides/upgrading/codemods 以及版本指南 https://nextjs.org/docs/app/guides/upgrading/version-16、version-15、version-14(按需调整版本号)。根据当前版本确定升级路径,跨大版本时逐步升级(如 13 → 14 → 15)。优先运行 codemod 自动化处理破坏性变更:npx @next/codemod@latest <transform> <path>,常见 transform 有 next-async-request-api(v15 异步 Request API)、next-request-geo-ip(v15 geo/ip 属性迁移)、next-dynamic-access-named-export(v15 动态导入转换)。随后同步升级依赖:npm install next@latest react@latest react-dom@latest;如使用 TypeScript,再执行 npm install @types/react@latest @types/react-dom@latest。之后对照升级指南检查需手动修改的破坏性变更,如 API 变化(v15 的异步 params)、next.config.js 配置变更、被移除的废弃特性。最后运行 npm run build 检查构建错误,运行 npm run dev 测试关键功能。
适用场景:Next.js 版本升级、运行 codemod、项目迁移。
限制:资料未提供具体支持的版本范围、失败回滚方式、依赖冲突处理细节及收费信息。