NNext.js 中文网 GitHub

如何升级到版本 14

将你的 Next.js 应用程序从版本 13 升级到 14。

从 13 升级到 14#

要更新到 Next.js 版本 14,请使用你偏好的包管理器运行以下命令:

Terminal
npm i next@next-14 react@18 react-dom@18 && npm i eslint-config-next@next-14 -D
Terminal
yarn add next@next-14 react@18 react-dom@18 && yarn add eslint-config-next@next-14 -D
Terminal
pnpm i next@next-14 react@18 react-dom@18 && pnpm i eslint-config-next@next-14 -D
Terminal
bun add next@next-14 react@18 react-dom@18 && bun add eslint-config-next@next-14 -D

小知识: 如果你使用 TypeScript,请确保同时将 @types/react 和 @types/react-dom 升级到最新版本。

v14 摘要#

  • 由于 16.x 已停止维护,最低 Node.js 版本已从 16.14 提升到 18.17。
  • next export 命令已移除,改用 output: 'export' 配置。请参阅文档了解更多信息。
  • ImageResponse 的 next/server 导入已重命名为 next/og。可以使用 codemod 安全、自动地重命名你的导入。
  • @next/font 包已完全移除,改用内置的 next/font。可以使用 codemod 安全、自动地重命名你的导入。
  • next-swc 的 WASM 目标已移除。

检查迁移清单#

  • 应用使用 Node.js 18.17 或更高版本,以及兼容的 React 18 依赖项和类型。
  • 静态导出使用 output: 'export' 和 next build,而非 next export。
  • ImageResponse 的导入使用 next/og,而非 next/server。
  • 字体导入使用 next/font,而非 @next/font。
  • 应用不依赖已移除的 next-swc WASM 目标。
  • 应用支持的检查和受影响的运行时行为均通过。
Next.js 中文网