如何升级到版本 13
将你的 Next.js 应用从版本 12 升级到 13。
从 12 升级到 13#
要更新到 Next.js 版本 13,请使用你偏好的包管理器运行以下命令:
npm i next@13 react@latest react-dom@latest eslint-config-next@13yarn add next@13 react@latest react-dom@latest eslint-config-next@13pnpm i next@13 react@latest react-dom@latest eslint-config-next@13bun add next@13 react@latest react-dom@latest eslint-config-next@13小知识: 如果你使用 TypeScript,请确保同时将
@types/react和@types/react-dom升级到最新版本。
v13 摘要#
- 支持的浏览器已更改,不再支持 Internet Explorer,而是面向现代浏览器。
- 最低 Node.js 版本已从 12.22.0 提升到 16.14.0,因为 12.x 和 14.x 已停止维护。
- 最低 React 版本已从 17.0.2 提升到 18.2.0。
swcMinify配置属性已从false更改为true。有关更多信息,请参阅 Next.js Compiler。next/image导入已重命名为next/legacy/image。next/future/image导入已重命名为next/image。可以使用 codemod 安全自动地重命名你的导入。next/link的子元素不能再是<a>。添加legacyBehavior属性以使用旧行为,或移除<a>以完成升级。可以使用 codemod 自动升级你的代码。target配置属性已被移除,并由 Output File Tracing 取代。
迁移共享功能#
Next.js 13 引入了新的 app 目录,其中包含新的功能和约定。但是,升级到 Next.js 13 并不要求使用新的 app Router。
你可以继续使用 pages,并使用在两个目录中都可用的新功能,例如更新后的 Image 组件、Link 组件、Script 组件和字体优化。
<Image/> 组件#
Next.js 12 通过临时导入 next/future/image 为 Image 组件引入了许多改进。这些改进包括更少的客户端 JavaScript、更轻松地扩展和设置图片样式、更好的可访问性以及浏览器原生懒加载。
从 Next.js 13 开始,这一新行为现已成为 next/image 的默认行为。
有两个 codemod 可帮助你迁移到新的 Image 组件:
- next-image-to-legacy-image:此 codemod 将安全自动地将
next/image导入重命名为next/legacy/image,以保持与 Next.js 12 相同的行为。我们建议运行此 codemod 以快速自动更新到 Next.js 13。 - next-image-experimental:运行上一个 codemod 后,你可以选择运行此实验性 codemod,将
next/legacy/image升级为新的next/image,它会移除未使用的属性并添加内联样式。请注意,此 codemod 是实验性的,仅涵盖静态用法(例如<Image src={img} layout="responsive" />),不涵盖动态用法(例如<Image {...props} />)。
<Link> 组件#
<Link> 组件不再需要手动添加 <a> 标签作为子元素。此行为在 version 12.2 中作为实验性选项添加,现在已成为默认行为。在 Next.js 13 中,<Link> 始终渲染 <a>,并允许你将属性转发给底层标签。
例如:
import Link from 'next/link'
// Next.js 12:`<a>` 必须嵌套,否则会被排除
<Link href="/about">
<a>About</a>
</Link>
// Next.js 13:`<Link>` 始终在底层渲染 `<a>`
<Link href="/about">
About
</Link>要将链接升级到 Next.js 13,可以使用 new-link codemod。
<Script> 组件#
next/script 的行为已更新,以同时支持 pages 和 app。如果要逐步采用 app,请阅读升级指南。
字体优化#
以前,Next.js 通过内联字体 CSS 来帮助你优化字体。版本 13 引入了新的 next/font 模块,使你能够自定义字体加载体验,同时仍然确保出色的性能和隐私。
请参阅优化字体以了解如何使用 next/font。