Source profileQuality 57/100

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 编写的增量捆绑器,能显著加快开发启动和热更新的速度。

Best for

    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

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    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.

    Source-detected install commandSource
    npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/nextjs-turbopack"
    Safe inspection promptEditorial

    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

    1. 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 文档。
    2. 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 下;基本使用无需额外配置。
    3. 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

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score57/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars234,327SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guidecatalog recordEditorialGenerated 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