发布·  

Nuxt 4 路线图

我们有一些关于 Nuxt 4 路线图的激动人心的消息,包括新的时间表以及未来几周的预期。
Daniel Roe

Daniel Roe

@danielroe.dev

我们最初计划在 2024 年 6 月发布 Nuxt 4,但事情并不总是按计划进行。我认为采取不同的方法是合适的。

👉 Nuxt 4 于 2025 年 7 月 8 日进入发布候选 (RC) 阶段,稳定版本即将发布。Nuxt 5 将在 Nitro v3 准备就绪后发布。

为什么分两次发布?

老实说,事后看来,我认为我们去年就应该发布 Nuxt v4 了。这会更好地符合我们每年发布一个主要版本的计划。

另一方面,它通过一个标志选择 Nuxt 4 的重大更改,为无数项目的测试提供了时间。我认为我们应该继续发布这些更改作为 Nuxt v4,原因有二:

  1. 人们已经在使用它了。我经常听说有团队在生产环境中使用 compatibilityVersion: 4。这个选项最初只用于测试,但它已被证明足够稳定,可以用于生产。我们希望使其正式化,并为这些团队提供稳定版本的保护。
  2. 它将改进迁移。从 v3 -> v4,然后从 v4 -> v5 的两阶段迁移将使迁移更加顺畅。我们还没有 Nitro v3 破坏性更改的最终列表,这意味着我们可以花足够的时间确保 Nitro 升级顺利进行,同时不延迟我们去年计划的 Nuxt 更改的采用。

更重要的是,未来我们将尽力将 Nuxt 版本与 Vite 或 Nitro 等关键依赖项解耦。

包含什么?

Nuxt 4 包含了您通过 compatibilityVersion: 4 测试的所有功能。

  • 🗂️ 新的目录结构 - 代码放在 app/ 中,以实现更清晰的组织和更好的 IDE 性能
  • 🔄 改进的数据获取 - 更智能的 useAsyncDatauseFetch,具有更好的缓存和清理功能
  • 🏷️ 一致的组件名称 - Vue DevTools 和 <KeepAlive> 现在看到的名称与 Nuxt 的自动导入相同
  • 📄 增强的头部管理 - 放弃 Unhead v2 中已弃用的功能,具有更好的性能和标签优化

... 以及在升级指南中记录的许多其他改进。我们还将发布一些进一步的更改,包括:

  • 为采用 Vite 环境 API(使用单个开发服务器)做准备
  • 改进类型“环境”处理(用于服务器、客户端和共享代码)

Nitro 怎么样?

我们不会延迟采用 Nitro v3。我们的目标是 Nuxt 5 与 Nitro v3 同时发布,即使这只比 Nuxt v4 发布晚几个月。

尽管过去一年有所延迟,但我们看到 Nitro 取得了惊人的进展。作为一个团队,我们非常兴奋地揭示我们在 Nitro v3 和 h3 v2 中计划的内容。

虽然 Nuxt 4 最初不会包含这些升级,但并行发布 Nuxt v4 和 Nitro v3 意味着我们可以在 Nuxt 5 发布时更彻底地测试生态系统中的 Nuxt 和 Nitro。

Nuxt 3 怎么样?

我们将在 Nuxt 4 首次稳定发布后继续为 Nuxt 3 提供维护和支持,并在 Nuxt 5 发布后继续支持 Nuxt 3 和 Nuxt 4。我们特意为这些版本选择了稍短的六个月支持时间表,因为我们相信这将是一个简单的升级。

(我升级 Nuxt 4 的主要目标是确保它尽可能顺利。)

尽管如此,我将密切关注生态系统迁移的成功和速度。如果出现问题,我绝对会延长六个月的持续维护窗口。我们不想让任何人掉队。

一段时间内,这将意味着在三个版本之间积极地进行功能和错误修复的反向移植。但我认为这是值得的。毕竟,我们过去一年一直在为 Nuxt 4 做准备。

Nuxt 3持续接收更新,直到 2025 年底
Nuxt 4支持到 2026 年年中(预计)
Nuxt 5按照我们通常的模式提供长期支持

下一步

Nuxt v4 现已进入 发布候选 (RC) 阶段!我们希望早期采用者进行测试。请向 Nuxt 或您可能使用的任何模块报告问题。

我们目前处于发布候选阶段:在稳定发布之前,不再计划进行重大更改——只有错误修复。Nuxt 4 的发布阶段
  • Alpha:实验性功能和重大更改
  • RC(现在):稳定的功能集,发布前的最终测试

以下是未来几周的预期

  • 我们计划在nuxt/modules注册表中打开社区模块的上游 PR,并为模块作者创建迁移指南。
  • 我们将为 Nuxt 3 用户创建一份完整的升级指南,包括重大更改列表以及如何迁移。(当前的升级指南解释了如何启用兼容模式,但与 Nuxt 4 有一些差异。)
  • 本月我们将只发布 v3 的错误修复,将新功能的反向移植推迟到 v4 发布之后。
  • 我们将更新 nuxt.com 上的文档,允许在 3.x4.x 和(很快)5.x 文档之间切换。
  • 发布候选版现已上线,我们只专注于错误修复。预计不会有新功能或重大更改。
  • v4 发布后,我们将把 main 分支分离到 4.x,以采用 h3nitro 的边缘版本,并开始 Nuxt 5 的开发。
您可以通过查看以下内容来跟踪剩余工作的进展:这些剩余任务等等Nuxt 4 里程碑在 GitHub 上。

我对这个时间表感到非常兴奋——感谢您在过去一年中的耐心和信任!