当初、Nuxt 4は2024年6月に計画していましたが、物事は常に計画通りにはいきません。異なるアプローチをとるのが適切だと考えます。
👉 Nuxt 4は2025年7月8日にリリース候補 (RC) ステージに入り、安定版リリースが間もなく登場します。Nuxt 5はNitro v3の準備が整い次第リリースされます。
なぜ2つのリリースに分けるのか？
正直なところ、今思えばNuxt v4は昨年リリースすべきだったと思います。年に一度の慎重なメジャーリリースという計画にもっと合致していたでしょう。
一方で、単一のフラグでNuxt 4の破壊的変更をオプトインすることで、数え切れないほどのプロジェクトでテストする時間が得られました。これらの変更をNuxt v4としてリリースすべきだと考える理由は2つあります。
- すでに多くの人が使っているから。頻繁に、本番環境で
compatibilityVersion: 4を使用しているチームの話を聞きます。このオプションはテスト目的でしたが、本番での使用にも十分堅牢であることが証明されました。これを正式なものとし、これらのチームに安定版リリースの保護を提供したいと考えています。 - 移行を改善するから。v3 -> v4、そしてv4 -> v5という2段階の移行にすることで、よりスムーズな移行が可能になります。Nitro v3の破壊的変更の最終リストはまだありませんが、これにより、過去1年間計画してきたNuxtの変更の導入を遅らせることなく、Nitroのアップグレードがスムーズに進むよう十分な時間を確保できます。
さらに、今後はViteやNitroのような主要な依存関係からNuxtのリリースを切り離すために最善を尽くします。
含まれるもの
Nuxt 4には、compatibilityVersion: 4でテストしてきたすべての機能が含まれます。
- 🗂️ 新しいディレクトリ構造 - よりクリーンな構成と優れたIDEパフォーマンスのためにコードは
app/に配置されます。 - 🔄 改善されたデータ取得 - より優れたキャッシュとクリーンアップを備えた、よりスマートな
useAsyncDataとuseFetch。 - 🏷️ 一貫性のあるコンポーネント名 - Vue DevToolsと
<KeepAlive>は、Nuxtの自動インポートと同じ名前を見るようになりました。 - 📄 強化されたヘッド管理 - Unhead v2の非推奨機能を削除し、パフォーマンスとタグの最適化を改善。
...その他、アップグレードガイドに記載されている多くの改善が含まれます。さらに、以下を含むいくつかの変更を予定しています。
- Vite環境API（単一の開発サーバーで）の採用準備
- タイプ「environment」の取り扱い（サーバー、クライアント、共有コード用）の改善
Nitroについては？
Nitro v3の導入を遅らせるつもりはありません。Nuxt 5は、当初予定していたのと同時期にNitro v3とともに登場することを目指しています。たとえそれがNuxt v4のリリースから数ヶ月後であってもです。
過去1年間の遅延にもかかわらず、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の両方をサポートし続けます。私たちは意図的に、これらの各リリースに対して6ヶ月というやや短いサポート期間を選択しました。これは、アップグレードが簡単であると信じているからです。
（Nuxt 4のアップグレードにおける私の主な目標は、可能な限りスムーズにすることです。）
それでも、エコシステムがどれだけ成功し、迅速に移行するかを注意深く監視します。問題がある場合は、この6ヶ月間の継続的なメンテナンス期間を必ず延長します。誰も取り残したくありません。
しばらくの間、これは3つのバージョンにわたる機能とバグフィックスのアクティブなバックポートを意味します。しかし、それだけの価値があると思います。そして、Nuxt 4の準備として、この1年間これを実行してきました。
| Nuxt 3 | 2025年末までアップデートを受け続ける |
| Nuxt 4 | 2026年半ばまでサポート（予定） |
| Nuxt 5 | 通常のパターンに従って長期サポート |
次は何？
Nuxt v4は現在、リリース候補 (RC) ステージです！早期導入者の皆様にテストしていただきたいです。使用しているNuxtまたはモジュールについて、問題があればぜひ報告してください。
- アルファ：実験的な機能と破壊的変更
- RC（現在）：安定した機能セット、リリース前の最終テスト
今後数週間に期待できることは次のとおりです。
- コミュニティモジュール向けのアップストリームPRを、nuxt/modulesレジストリで公開し、モジュール作者向けの移行ガイドを作成する予定です。
- Nuxt 3ユーザー向けの完全なアップグレードガイドを作成します。これには、破壊的変更のリストと移行方法が含まれます。（現在のアップグレードガイドでは互換モードを有効にする方法が説明されていますが、Nuxt 4とはいくつかの違いがあります。）
- 今月はv3のバグ修正のみをリリースし、新機能のバックポートはv4のリリース後まで延期します。
- nuxt.comのドキュメントを更新し、
3.x、4.x、そして（まもなく）5.xのドキュメントを切り替えられるようにします。 - リリース候補が公開された今、バグ修正にのみ注力しています。新機能や破壊的変更は予定されていません。
- v4がリリースされたら、
mainブランチを4.xに分離し、h3とnitroのエッジリリースを採用し、Nuxt 5の開発を開始します。
このタイムラインに本当にワクワクしています。そして、この1年間のご辛抱と信頼に感謝します！