v4 路线图

我们最初计划在 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 自动导入相同的名称
• 📄 增强的头部管理 - 放弃 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。

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