SuperAPI AI 工具集

next-upgrade

前端与建站

查看项目

更新于 10-15 20:27

技能介绍

用途:将当前 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(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。升级后运行 npm run build 检查构建错误,并运行 npm run dev 测试关键功能。

适用场景:需要跟进 Next.js 新版本、处理版本升级带来的 API 与配置变更的前端项目。

限制:具体版本对应的迁移步骤、配置变更与废弃特性需以官方升级指南为准;资料未提供支持的版本范围、自动化程度及失败回滚方式,暂未提供。