---
title: "v4 路线图"
description: "我们为 Nuxt 4 的路线图带来了一些令人兴奋的消息，包括新的时间表以及未来几周的预期。"
canonical_url: "https://nuxt.zhcndoc.com/blog/roadmap-v4"
---
# v4 路线图

> 我们为 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 自动导入相同的名称
- **📄 增强的头部管理** - 放弃 Unhead v2 的过时功能，性能更好，标签优化更佳

…以及许多其他改进，详见[升级指南](https://nuxt.zhcndoc.com/docs/getting-started/upgrade)。我们还将发布若干额外改动，包括：

- 为采用 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 或您可能使用的任何模块报告问题。

::note
我们目前处于 **候选发布阶段**：不再计划重大更改 — 仅在稳定发布之前进行错误修复。

Nuxt 4 的发布阶段：

- **Alpha**: 试验性功能和破坏性更改
- **RC (now)**: 稳定的功能集，发布前的最终测试
::

接下来几周你可以期待以下内容：

- 我们计划在 [nuxt/modules](https://github.com/nuxt/modules) 注册表中为社区模块打开 **上游 PR**，并为模块作者创建迁移指南。
- 我们将为 Nuxt 3 用户创建完整的 **升级指南**，包括破坏性更改的列表以及如何迁移。（当前的 [升级指南](https://nuxt.zhcndoc.com/docs/getting-started/upgrade) 解释了如何启用兼容模式，但与 Nuxt 4 有一些不同之处。）
- 本月我们将 **仅发布 v3 的错误修复**，推迟在 v4 发布后再移植新功能。
- 我们将 **更新 [nuxt.com](https://nuxt.zhcndoc.com/) 上的文档**，以允许在 `3.x`、`4.x` 和（即将）`5.x` 文档之间切换。
- 随着 **候选发布现已上线**，我们将专注于错误修复。不再预期有新功能或重大更改。
- 一旦 v4 发布，我们将把 `main` 分支分离到 `4.x`，以采用 `h3` 和 `nitro` 的边缘版本，并开始开发 Nuxt 5。

::note
你可以通过查看 GitHub 上的[剩余任务](https://github.com/nuxt/nuxt/issues/27027)和 [Nuxt 4 里程碑](https://github.com/nuxt/nuxt/milestone/8)来跟踪剩余工作的进展。
::

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


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.