Дорожная карта до v4

Изначально Nuxt 4 планировали на июнь 2024, но планы меняются. Мы решили пойти другим путём:

👉 Nuxt 4 перешёл в стадию Release Candidate (RC) 8 июля 2025, стабильный релиз — скоро. Nuxt 5 выйдет позже, когда будет готов Nitro v3.

Зачем два релиза?

Честно говоря, Nuxt v4 стоило выпустить в прошлом году — это лучше совпало бы с нашим циклом мажорных релизов.

С другой стороны, за это время многие проекты протестировали режим совместимости с v4 одним флагом. Выпускать эти изменения как Nuxt v4 имеет смысл по двум причинам:

1. Им уже пользуются. Команды используют compatibilityVersion: 4 в продакшене. Опция задумывалась для тестов, но оказалась достаточно стабильной. Мы хотим сделать её официальной и дать таким командам стабильный релиз.
2. Миграция станет проще. Два этапа — v3 → v4 и затем v4 → v5 — упростят переход. Финального списка breaking changes для Nitro v3 пока нет, так что мы успеем сделать переход на Nitro плавным и при этом не откладывать внедрение изменений Nuxt, которые готовили весь год.

Кроме того, мы по возможности будем разводить релизы Nuxt и ключевых зависимостей (Vite, Nitro).

Что входит в Nuxt 4?

Всё, что вы уже пробовали с compatibilityVersion: 4:

• 🗂️ Новая структура — код в app/, понятная организация и быстрее работа IDE
• 🔄 Загрузка данных — умнее useAsyncData и useFetch, лучше кэш и очистка
• 🏷️ Имена компонентов — Vue DevTools и <KeepAlive> видят те же имена, что и автоимпорты Nuxt
• 📄 Управление head — отказ от устаревшего в Unhead v2, быстрее и лучше оптимизация тегов

Плюс другие улучшения из руководства по обновлению. Будет ещё несколько изменений:

• подготовка к Vite Environment API (один dev-сервер)
• улучшенная обработка типа environment (сервер, клиент, общий код)

А Nitro?

Мы не откладываем переход на Nitro v3. Nuxt 5 планируем выпустить вместе с Nitro v3 в изначальные сроки, даже если это через несколько месяцев после Nuxt v4.

Несмотря на задержки, прогресс по Nitro за год большой. Мы с нетерпением покажем планы по Nitro v3 и h3 v2.

Nuxt 4 сначала выйдет без этих обновлений; параллельный релиз Nuxt v4 и Nitro v3 позволит лучше протестировать оба в экосистеме к моменту выхода Nuxt 5.

А Nuxt 3?

После стабильного релиза Nuxt 4 мы продолжим поддерживать Nuxt 3 — и после выхода Nuxt 5 будем поддерживать и v3, и v4. Срок поддержки каждой ветки мы намеренно сделали короче — шесть месяцев, считая переход достаточно простым.

(Главная цель — сделать обновление до Nuxt 4 максимально гладким.)

Я буду следить за тем, как быстро экосистема мигрирует. При проблемах продлю окно поддержки. Никого не хотим оставлять без обновлений.

Какое-то время будем активно бэкпортить фичи и исправления в три версии. Мы уже делали это весь прошлый год при подготовке Nuxt 4.

Дальнейшие шаги

Nuxt v4 сейчас в стадии Release Candidate (RC)! Приглашаем ранних пользователей протестировать. Сообщайте о проблемах в Nuxt или в используемых модулях.

Here's what you can expect over the next few weeks:

• We plan to open upstream PRs for community modules in the nuxt/modules registry, and create a migration guide for module authors.
• We'll create a full upgrade guide for Nuxt 3 users, including a list of breaking changes and how to migrate. (The current upgrade guide explains how to enable compatibility mode, but there are some differences with Nuxt 4.)
• We'll only release bugfixes for v3 this month, deferring backporting new features until after the release of v4.
• We'll update the docs on nuxt.com to allow switching between 3.x, 4.x and (soon) 5.x documentation.
• With the release candidate now live, we're focused exclusively on bug fixes. No new features or breaking changes are expected.
• Once v4 is released, we'll separate the main branch to 4.x to adopt edge releases of h3 and nitro and begin development of Nuxt 5.

Я рад такому плану — и благодарю за терпение и доверие в прошлом году!