升级 Next.js 是做什么的?
按照官方迁移指南将当前项目升级到最新的 Next.js 版本。
说明
-
检测当前版本:读取
package.json,确定当前的 Next.js 版本以及相关依赖(React、React DOM 等)。 -
获取最新的升级指南:使用 WebFetch 获取官方升级文档:
-
确定升级路径:基于当前版本,识别哪些迁移步骤适用。对于大版本跳跃,应逐步升级(例如 13 → 14 → 15)。
-
首先运行 codemods:Next.js 提供了 codemods 来自动处理破坏性变更:
npx @next/codemod@latest <transform> <path>常用的转换:
next-async-request-api- 更新异步 Request API(v15)next-request-geo-ip- 迁移 geo/ip 属性(v15)next-dynamic-access-named-export- 转换动态导入(v15)
-
更新依赖:一起升级 Next.js 及其对等依赖:
npm install next@latest react@latest react-dom@latest -
审查破坏性变更:检查升级指南中需要的手动更改:
- API 变更(例如 v15 中的 async params)
next.config.js中的配置变更- 被移除的废弃功能
-
更新 TypeScript 类型(如果适用):
npm install @types/react@latest @types/react-dom@latest -
测试升级:
- 运行
npm run build检查构建错误 - 运行
npm run dev并测试关键功能
- 运行