SuperAPI AI 工具集

next-upgrade

前端与建站

查看项目

更新于 10-15 21:41

技能介绍

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

主要能力:读取 package.json 识别当前 Next.js 及 React、React DOM 等相关依赖版本;通过 WebFetch 获取官方升级文档,包括 codemods 指南与各版本升级指南(如 version-16、version-15、version-14);根据当前版本确定适用的迁移步骤,跨大版本时按增量方式升级(例如 13 → 14 → 15);先运行 codemod 自动化处理破坏性变更,再更新依赖、检查需手动修改的破坏性变更、更新 TypeScript 类型并测试升级结果。

使用方式:常用 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 项目迁移到新版本、并希望借助官方 codemod 减少手工改动的开发流程。

限制:资料未提供该技能的具体安装方式、支持的 Next.js 版本范围、是否收费、平台限制或自动化程度等细节,暂未提供。实际升级仍需人工审查官方升级指南中的 API 变更、next.config.js 配置变更及被移除的废弃功能。