SuperAPI AI 工具集

next-upgrade

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:将当前项目升级到最新 Next.js 版本,按官方迁移指南逐步完成迁移。

主要能力与步骤:先读取 package.json 识别当前 Next.js 及 React、React DOM 等相关依赖版本;再通过 WebFetch 获取官方升级文档,包括 codemods 页面与对应版本指南(如 version-15、version-14,可按需调整版本);据此确定升级路径,跨大版本时增量升级,例如 13 → 14 → 15。

使用方式:优先运行 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)。随后同步升级依赖:npm install next@latest react@latest react-dom@latest;如使用 TypeScript,再安装 npm install @types/react@latest @types/react-dom@latest。

之后对照升级指南审查需手动处理的破坏性变更,例如 v15 中 async params 等 API 变化、next.config.js 配置变化、被移除的废弃特性;最后运行 npm run build 检查构建错误,并运行 npm run dev 测试关键功能。

适用场景:需要跟随官方迁移路径升级 Next.js 的项目,尤其是涉及大版本跨越或存在已知 codemod 的场景。

限制:技能本身未说明更多功能细节;具体迁移项以官方指南为准,codemod 无法覆盖全部改动,需手动核查破坏性变更;资料未提供对非 Next.js 工具的兼容范围或性能、收费等信息。