Дорожная карта до 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 — упростят переход. Финального списка несовместимых изменений для 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 или в используемых модулях.

В ближайшие недели ожидайте следующее:

• Мы планируем открыть upstream PR для community-модулей (PR в основные репозитории) в реестре nuxt/modules и подготовить руководство по миграции для авторов модулей.
• Мы подготовим полное руководство по обновлению для пользователей Nuxt 3, включая список несовместимых изменений и шаги миграции. (Текущее руководство по обновлению объясняет, как включить режим совместимости, но есть отличия от Nuxt 4.)
• В этом месяце мы будем выпускать для v3 только исправления ошибок, отложив обратный перенос (backport) новых функций до релиза v4.
• Мы обновим документацию на nuxt.com, чтобы можно было переключаться между документацией 3.x, 4.x и (скоро) 5.x.
• Кандидат в релиз (release candidate) уже доступен — мы сосредоточены исключительно на исправлении ошибок. Новых функций и несовместимых изменений не ожидается.
• После релиза v4 мы отделим ветку main в 4.x, чтобы принять edge-релизы h3 и nitro и начать разработку Nuxt 5.

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