如何升级到版本 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 -DTerminal
yarn add next@next-14 react@18 react-dom@18 && yarn add eslint-config-next@next-14 -DTerminal
pnpm i next@next-14 react@18 react-dom@18 && pnpm i eslint-config-next@next-14 -DTerminal
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-swcWASM 目标。 - 应用支持的检查和受影响的运行时行为均通过。