Nuxt 4 路线图

我们最初计划在 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 性能
• 🔄 改进的数据获取 - 更智能的 useAsyncData 和 useFetch，具有更好的缓存和清理功能
• 🏷️ 一致的组件名称 - Vue DevTools 和 <KeepAlive> 现在看到的名称与 Nuxt 的自动导入相同
• 📄 增强的 Head 管理 - 淘汰 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 v4 现已进入 发布候选 (RC) 阶段！我们希望早期采用者进行测试。请向 Nuxt 或您可能正在使用的任何模块报告问题。

以下是您在未来几周内可以期待的内容

• 我们计划在nuxt/modules注册表中打开社区模块的上游 PR，并为模块作者创建迁移指南。
• 我们将为 Nuxt 3 用户创建一份完整的升级指南，包括破坏性更改列表以及如何迁移。（当前的升级指南解释了如何启用兼容模式，但与 Nuxt 4 存在一些差异。）
• 我们本月将只发布 v3 的错误修复，将新功能的反向移植推迟到 v4 发布之后。
• 我们将更新 nuxt.com 上的文档，以允许在 3.x、4.x 和（很快）5.x 文档之间切换。
• 随着发布候选版现已上线，我们目前只专注于错误修复。预计不会有新功能或破坏性更改。
• v4 发布后，我们将把 main 分支分离到 4.x，以采用 h3 和 nitro 的边缘版本，并开始开发 Nuxt 5。

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