Roadmap to Nuxt 4 詳細ガイド
1. リリースを二段階に分けた理由
- 早期テストとフィードバック
2025年7月8日にRC(Release Candidate)段階へ移行し、正式リリース前にコミュニティからの実運用テストとフィードバックを収集できるようにしました 。 - スムーズな移行パス
compatibilityVersion: 4
フラグを使い、Nuxt 3からNuxt 4への破壊的変更を段階的に検証可能にし、トラブルの早期検出を狙います 。
2. ロードマップと主要マイルストーン
フェーズ | 日付 | 主な内容 |
---|---|---|
Alpha | 2025年6月2日 | 最初のアルファ版リリース。主要機能の実装と初期テスト開始 |
Release Candidate (RC) | 2025年7月8日 | 機能セット確定・最終テストフェーズへ移行 |
Stable Release | 2025年7月末頃予定 | RCで報告されたバグ修正を経て正式リリース |
3. Nuxt 4の主な新機能
-
新ディレクトリ構造 (
app/
)pages/
を廃止し、すべてのアプリケーションコードをapp/
ディレクトリ配下に集約。- クライアント/サーバーコードの境界を明確化し、ファイルシステムのウォッチ性能を大幅に改善 。
-
データフェッチの再設計
useAsyncData
とuseFetch
における内部キャッシュ最適化で、同一エンドポイントへの重複リクエストを自動マージ。- サーバーサイドレンダリングとクライアントサイドで同一のデータ取得フローを保証 。
-
ヘッド管理(Metaタグ)の刷新
- Unhead v2への移行による重複タグ削除機能と、SEO向けの最適化ロジックを追加 。
-
Viteベースの開発環境強化
- Viteの環境変数APIサポートを導入し、開発サーバー起動時のパフォーマンスを向上。
- Hot Module Replacement(HMR)がさらに高速化 。
-
型安全性の向上
environment
型定義を強化し、サーバー/クライアント/共有コード間での型チェック精度をアップ 。
4. Nitro v3とNuxt 5への道
- Nitro v3統合テスト
RCフェーズ中にNitro v3との連携を深め、エコシステム全体での動作検証を実施。 - Nuxt 5リリース予定
Nitro v3安定後、数ヶ月以内にNuxt 5を公開。プラグインAPIの拡充や多言語対応も計画中 。
5. 移行ガイド:Nuxt 3から4へ
- Codemodsの活用
公式提供の
を使うことで、大半の破壊的変更を自動変換可能 。npx codemod@latest nuxt/4/migration-recipe
- 手動チェックポイント
nuxt.config
のオプション整理- プラグインの配置見直し(
plugins/
→app/plugins/
) - ミドルウェアAPIの更新
6. ベストプラクティスとコミュニティ活動
- RCフェーズでのフィードバック歓迎
GitHub DiscussionsやRFCスレッドで移行事例や問題点を共有すると、Nuxtチームが優先的に対応します。 - 実験的機能の試用
nuxt.config
のexperimental
セクションで新機能を早期に試せます 。 - 学習リソース
- 公式ドキュメント: https://nuxt.com/docs/4.x
- Vue School記事: ディレクトリ構造とデータフェッチの深掘り