Nextjs Turbopack

affaan-m/ECC/docs/ja-JP/skills/nextjs-turbopack

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775无许可证275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

Next.js 16+とTurbopack — インクリメンタルバンドリング、FSキャッシング、開発速度、Turbopackとwebpackをいつどちらかどうかを選ぶか。

AI 生成的概览

讲解 Next.js 16+ 的 Turbopack 用法、缓存机制,以及何时选用 Turbopack 或 webpack。

功能
该技能提供 Next.js 16+ 与 Turbopack 的使用指导,涵盖增量打包、文件系统缓存和开发速度。它说明何时使用 Turbopack、何时改用 webpack,开发默认行为如何运作,以及如何用实验性打包分析器检查产物。它还列出 next dev、next build、next start 等命令和最佳实践。
适用场景
适用于开发或调试 Next.js 16+ 应用、诊断开发启动或热更新缓慢,以及优化生产打包产物的场景。在决定是否禁用 Turbopack 改用 webpack 时也有参考价值。
运行要求
不包含脚本或依赖包,仅为说明性内容。假定已有 Next.js 16+ 项目,并熟悉 Next.js 命令行与官方文档。

Next.jsとTurbopack

Next.js 16+はローカル開発にデフォルトでTurbopackを使用する。TurbopackはRustで書かれたインクリメンタルバンドラーで、開発起動時間とホットアップデートを大幅に高速化する。

使用するタイミング

  • Turbopack(デフォルト開発): 日々の開発に使用する。特に大規模アプリでコールドスタートとHMRが速い。
  • Webpack(レガシー開発): Turbopackのバグに遭遇した場合、またはwebpackのみのプラグインに依存している場合のみ使用する。--webpack(またはNext.jsのバージョンによっては--no-turbopack)で無効化する。リリースのドキュメントを確認すること。
  • プロダクション: プロダクションビルドの動作(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ドキュメントを参照)。

例

コマンド

bash
next devnext buildnext start

使用方法

ローカル開発にはTurbopackでnext devを実行する。バンドルアナライザー(Next.jsドキュメント参照)を使用してコード分割を最適化し、大きな依存関係を削減する。可能な限りApp RouterとサーバーコンポーネントをBestPracticeとして使用する。

ベストプラクティス

  • 安定したTurbopackとキャッシングの動作のために最新のNext.js 16.xを使い続ける。
  • 開発が遅い場合は、Turbopack(デフォルト)を使用していることと、キャッシュが不必要にクリアされていないことを確認する。
  • プロダクションバンドルサイズの問題には、使用中のバージョンの公式Next.jsバンドル解析ツールを使用する。

来源与署名

来源:affaan-m/ECC位于docs/ja-JP/skills/nextjs-turbopack提交ef648e0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架