用途:为 JavaScript/TypeScript monorepo 提供 Turborepo 构建系统指导,覆盖任务流水线、依赖图并行执行与缓存。触发场景包括 turbo.json、dependsOn、缓存、远程缓存、turbo CLI 与 --filter 等。
主要能力:任务配置(dependsOn、outputs、persistent、with、interruptible)、环境变量处理、缓存与远程缓存、过滤与只跑变更包(--affected)、CI 集成(GitHub Actions、Vercel)、watch 模式、包结构与最佳实践、架构边界检查(turbo boundaries)。
必要用法:任务脚本必须写在各包的 package.json 中,并在根 turbo.json 注册;根 package.json 只通过 turbo run <task> 委派,不写任务逻辑。写入代码或 CI 时始终使用 turbo run,如 turbo run build --affected;简写 turbo <task> 仅用于人工终端一次性命令。依赖构建用 dependsOn: ["^build"],需先声明 workspace 依赖。只跑变更包用 turbo run build --affected。
限制与注意:不要用 --parallel 绕过依赖图;不要用 && 串联 turbo 任务;避免 prebuild 手动构建依赖;避免根目录 .env;环境变量需在 env 中声明才会参与哈希;.env 变更需加入 inputs;文件产出任务需配置 outputs;跨包引用用 $TURBO_ROOT$ 而非 ../。资料未提供安装命令、收费与价格信息。