affaan-m/ECC/docs/zh-CN/skills/nextjs-turbopack/SKILL.md
nextjs-turbopack
Review nextjs-turbopack's use cases, installation, workflow, and original source instructions.
- Source repository stars
- 234,327
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-27
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
Next.js 16+ 在本地开发中默认使用 Turbopack:这是一个用 Rust 编写的增量捆绑器,能显著加快开发启动和热更新的速度。
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/nextjs-turbopack"Inspect the Agent Skill "nextjs-turbopack" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/zh-CN/skills/nextjs-turbopack/SKILL.md at commit 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
何时使用
Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。 Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。 生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。
Turbopack (默认开发模式):用于日常开发。冷启动和热模块替换速度更快,尤其是在大型应用中。Webpack (旧版开发模式):仅当遇到 Turbopack 错误或依赖仅在开发中可用的 webpack 插件时使用。可通过 --webpack(或 --no-turbopack,具体取决于你的 Next.js 版本;请查阅你所用版本的文档)来禁用。生产环境:生产构建行为 (next build) 可能使用 Turbopack 或 webpack,这取决于 Next.js 版本;请查阅你所用版本的官方 Next.js 文档。 - 02
工作原理
Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。 开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。 文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。 捆绑包分析器 (Next.js 16.1+):实验性的捆绑包分析器,用于检查输出并发现重型依赖;可通过配置或实验性标志启用(请查阅你所用版本的 Next.js 文档)。
Turbopack:用于 Next.js 开发的增量捆绑器。利用文件系统缓存,因此重启速度要快得多(例如,在大型项目中快 5–14 倍)。开发环境默认启用:从 Next.js 16 开始,next dev 默认使用 Turbopack,除非被禁用。文件系统缓存:重启时会复用之前的工作成果;缓存通常位于 .next 下;基本使用无需额外配置。 - 03
示例
运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。
运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 57/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 234,327 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | catalog record | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- affaan-m/ECC
- Skill path
- docs/zh-CN/skills/nextjs-turbopack/SKILL.md
- Commit
- 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38
- License
- MIT
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
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
next build
next start
使用
运行 next dev 以使用 Turbopack 进行本地开发。使用捆绑包分析器(参见 Next.js 文档)来优化代码分割并剔除大型依赖。尽可能优先使用 App Router 和服务器组件。
最佳实践
- 保持使用较新的 Next.js 16.x 版本,以获得稳定的 Turbopack 和缓存行为。
- 如果开发速度慢,请确保你正在使用 Turbopack(默认),并且缓存没有被不必要地清除。
- 对于生产环境捆绑包大小问题,请使用你所用版本的官方 Next.js 捆绑包分析工具。
Alternatives
Compare before choosing
affaan-m/ECC
nextjs-turbopack
Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.
affaan-m/ECC
nextjs-turbopack
Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.
affaan-m/ECC
nextjs-turbopack
Next.js 16+ y Turbopack — bundling incremental, caché en sistema de archivos, velocidad de desarrollo y cuándo usar Turbopack frente a webpack.
affaan-m/ECC
nextjs-turbopack
Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.