SuperAPI AI 工具集

next-upgrade

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

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

主要能力:读取 package.json 检测当前 Next.js 及 React、React DOM 等相关依赖版本;通过 WebFetch 获取官方升级文档,包括 codemods 页面与各版本专属指南(如 version-16、version-15、version-14);根据当前版本确定适用的迁移步骤,跨大版本时建议逐步升级(例如 13 → 14 → 15);先运行 codemod 自动化处理破坏性变更,再进行依赖升级与手工变更检查。

使用方式:先跑 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。随后对照升级指南检查 API 变更(如 v15 的异步 params)、next.config.js 配置变更与被移除的废弃特性。最后运行 npm run build 检查构建错误,运行 npm run dev 测试关键功能。

适用场景:需要把既有 Next.js 项目迁移到新版、并希望借助官方 codemod 减少手工改动的前端项目维护场景。

限制:官方文档链接与 codemod 名称随 Next.js 版本变化,需以实际获取的官方指南为准;具体版本支持范围、收费情况与运行环境要求暂未提供。