Next.js 版本升级
给出现有 Next.js 项目的 package.json,产出到目标版本的升级路径、codemod 命令与破坏性变更核对清单。
功能与用途
Next.js 大版本升级时的坑集中在异步 params、废弃 API 和配置文件改动上。这个能力先读 package.json 定位当前版本,再去官方升级文档和 codemod 页面确认路径,跑 npx @next/codemod 自动改造,最后同步 React 与类型依赖并跑 build 验证。跨多个大版本时会按 13→14→15 这样逐级升。
适用场景
- 大版本升级前置评估:检查 package.json 依赖与破坏性变更,规划从旧版本逐级升级至目标版本的安全路径。
- 批量自动化 Codemod 改造:运行官方 codemod 自动迁移异步请求 API、动态导入和废弃配置,减少手工修改。
- 升级后构建与类型校验排障:同步升级 React 与相关类型包,运行生产构建并定位异步 params 等改动引发的报错。
适用人群
- 维护 Next.js 项目的全栈开发
- 负责框架升级的技术负责人
- 要处理遗留 Pages Router 迁移的前端工程师
使用步骤
- 把 package.json 发过去,让它先确认当前 Next.js、React、React DOM 版本
- 确认升级路径:是直接跳到最新版,还是按大版本逐级升
- 跑对应的 codemod,如 npx @next/codemod@latest next-async-request-api ./
- 一并升级 next、react、react-dom 与 @types 依赖,再核对破坏性变更清单
- 跑 npm run build 和 npm run dev 验证,确认关键功能正常
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.
使用前准备
- 一个已有的 Next.js 项目仓库,能执行 npm/npx 命令并可访问 nextjs.org 官方升级文档
依赖与权限
- 读取用户主动提供的内容