nextjs-turbopack
Next.js 16+ and Turbopack — incremental bundling, filesystem caching, development speed, and when to use Turbopack versus webpack.
Machine translationRead the original Chinese text
Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。
Target: React / Next.js. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original Chinese text
Topics in the source
- Next.js 与 Turbopack
- 何时使用
- 工作原理
- 示例
- 命令
- 使用
- 最佳实践
Next.js 16+ 在本地开发中默认使用 Turbopack:这是一个用 Rust 编写的增量捆绑器,能显著加快开发启动和热更新的速度。 Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。 Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。 生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。 适用场景:开发或调试 Next.js 16+ 应用,诊断开发启动或热模块替换速度慢的问题,或优化生产环境捆绑包。 Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。 开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。 文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。 捆绑包分析器 (Next.js 16.1+):实验性的捆绑包分析器,用于检查输出并发现重型依赖;可通过配置或实验性标志启用(请查阅你所用版本的 Next.js 文档)。 运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。 保持使用较新的 Next.js 16.x 版本,以获得稳定的 Turbopack 和缓存行为。 如果开发速度慢,请确保你正在使用 Turbopack(默认),并且缓存没有被不必要地清除。 对于生产环境捆绑包大小问题,请使用你所用版本的官方 Next.js 捆绑包分析工具。
- Source repository
- affaan-m/ECC
- Source file
- docs/zh-CN/skills/nextjs-turbopack/SKILL.md
- Fixed revision
- d2ef2680594f9a17526a6e1a2e18b3d242c5d17b
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: affaan-m/ECC · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-09T15:01:42.477Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.