Next.js と Turbopack
Next.js 16+ は、ローカル開発でデフォルトで Turbopack を使用します。Turbopack は Rust で書かれたインクリメンタルバンドラーで、開発の起動やホットリロードを大幅に高速化します。
いつ使用するか
- Turbopack(デフォルト開発モード):日常の開発に最適です。特に大規模アプリケーションでのコールドスタートや HMR(Hot Module Replacement)が高速化されます。
- Webpack(旧開発モード):Turbopack でエラーが発生する場合や、利用している webpack プラグインが開発時にのみ必要な場合に使用します。
--webpackまたは--no-turbopackフラグで無効化できます(お使いの Next.js バージョンのドキュメントを参照してください)。 - プロダクション環境:プロダクションビルド(
next build)は、Next.js のバージョンに応じて Turbopack または webpack を使用します。お使いのバージョンの公式 Next.js ドキュメントをご確認ください。
適用シナリオ:Next.js 16+ アプリケーションの開発やデバッグ、開発起動や HMR の遅延の診断、プロダクションバンドルの最適化。
仕組み
- Turbopack:Next.js 開発のためのインクリメンタルバンドラー。ファイルシステムキャッシュを活用するため、再起動が大幅に高速化されます(例:大規模プロジェクトで 5~14 倍高速)。
- 開発環境でデフォルト有効:Next.js 16 以降、
next devは無効化されない限りデフォルトで Turbopack を使用します。 - ファイルシステムキャッシュ:再起動時に以前の処理結果を再利用します。キャッシュは通常
.nextディレクトリに保存され、基本的な使用では追加設定は不要です。 - バンドルアナライザー(Next.js 16.1+):出力を検査し、重い依存関係を特定するための実験的なバンドルアナライザーです。設定または実験的フラグで有効化できます(お使いの Next.js バージョンのドキュメントを参照してください)。
例
コマンド
next dev
next build
next start
使用方法
ローカル開発では next dev を実行して Turbopack を使用します。バンドルアナライザー(Next.js ドキュメント参照)を使用してコード分割を最適化し、大きな依存関係を除去してください。可能な限り App Router とサーバーコンポーネントを優先してください。
ベストプラクティス
- 安定した Turbopack とキャッシュの動作を確保するため、最新の Next.js 16.x バージョンを維持してください。
- 開発が遅い場合は、Turbopack(デフォルト)を使用していることと、キャッシュが不必要にクリアされていないことを確認してください。
- プロダクションバンドルのサイズ問題については、お使いのバージョンの公式 Next.js バンドル分析ツールを使用してください。