mcpField
N
next-upgrade

next-upgrade

github.com/vercel-labs开发1.7k1.1k 次安装34 周前更新
代码仓库

关于 next-upgrade

指导开发者依据官方迁移指南，将现有项目升级到最新 Next.js 版本。流程涵盖版本检查、升级路径、codemod、依赖更新和构建测试。

主要功能

  1. 01检查 Next.js 与相关依赖版本
  2. 02查找对应的官方升级指南
  3. 03规划逐版本迁移路径
  4. 04优先运行 codemod
  5. 05更新依赖与 TypeScript 类型
  6. 06通过构建和运行测试

适用场景

  1. 01确定项目适用的升级步骤
  2. 02自动转换破坏性变更
  3. 03同步升级 Next.js 与 React 依赖
  4. 04验证升级后的构建和关键功能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vercel-labs/openreview --skill next-upgrade

安装后在 Claude Code 中输入/next-upgrade确认已加载。

详细介绍

升级 Next.js

按照官方迁移指南，将当前项目升级到最新版本的 Next.js。

说明

  1. 检测当前版本：读取 package.json，确定当前 Next.js 版本及相关依赖项（React、React DOM 等）

  2. 获取最新升级指南：使用 WebFetch 获取官方升级文档：

  3. 确定升级路径：根据当前版本确定适用的迁移步骤。跨越多个主版本时，请逐步升级（例如，13 → 14 → 15）。

  4. 先运行 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）

  5. 更新依赖项：同时升级 Next.js 和对等依赖项：

    npm install next@latest react@latest react-dom@latest

  6. 检查破坏性变更：查看升级指南，了解需要手动进行的更改：

    • API 变更（例如，v15 中的异步 params）
    • next.config.js 中的配置变更
    • 将被移除的弃用功能

  7. 更新 TypeScript 类型（如适用）：

    npm install @types/react@latest @types/react-dom@latest

  8. 测试升级：

    • 运行 npm run build，检查构建错误
    • 运行 npm run dev 并测试关键功能

评论

支持 Markdown