用途:Turborepo 是 JavaScript/TypeScript monorepo 的构建系统,基于依赖图并行执行任务并缓存任务输出。本资料是一份使用指导技能,触发场景包括 turbo.json、任务流水线、dependsOn、缓存、远程缓存、turbo CLI、--filter、--affected 与 CI 等。
主要能力与规则:任务应定义在每个相关包的 package.json 中,并在根 turbo.json 注册;根 package.json 只通过 turbo run <task> 进行委派,不应把任务逻辑放在根目录,否则会破坏并行化。根任务(//#taskname)仅用于确实无法放入包内的少见情况。写入代码或 CI 时应始终使用 turbo run(如 turbo run build --affected),简写形式只用于人工或智能体在终端一次性输入。
常用用法:--affected 是只运行变更包及其下游依赖的主要方式,可配合 --affected-base 指定基线分支;--filter=web 按包名过滤,--filter=./apps/* 按目录,--filter=web... 含依赖,--filter=...web 含被依赖方。缓存方面,任务产出文件时需在 outputs 中声明路径,否则输出不会被缓存;环境变量需在 env 键声明,.env 变更需放入 inputs 才会触发重建;调试可用 --summarize 或 --dry,跳过缓存可用 --force 或 cache: false。任务依赖中 ^build 表示先构建依赖包,build 表示同包内先执行该任务;^build 只在已声明工作区依赖时生效。
适用场景与限制:适用于 monorepo 的任务编排、缓存、过滤、CI 与边界检查等场景,资料对配置、缓存、过滤、环境变量、CI、watch、包结构与最佳实践均给出索引式说明。资料未提供具体安装命令、收费与价格信息以及平台支持细节,这些内容暂未提供。