用途:面向 JavaScript/TypeScript monorepo 的构建系统使用指导,基于依赖图并行执行任务并缓存任务输出。主要能力:任务流水线配置(turbo.json 的 tasks、dependsOn、outputs)、本地与远程缓存、依赖图并行执行、包过滤(--filter、--affected)、CI 集成、watch 模式、包边界检查(turbo boundaries)。核心约定:不要在根 package.json 写任务逻辑,任务脚本应写在每个相关包的 package.json 中,并在根 turbo.json 注册;根脚本只通过 turbo run <task> 委派,否则会破坏并行化。写入代码或 CI 时必须用 turbo run,例如 scripts 中写 "build": "turbo run build",CI 中写 turbo run build --affected;简写 turbo build 仅用于人工或智能体的一次性终端命令。改动包选择推荐用 turbo run build --affected,可自动对比默认分支并包含依赖方,也可用 --affected-base 或 --filter=...[origin/main]。缓存问题常见原因:缺少 outputs、环境变量未在 env 声明、.env 未加入 inputs。环境变量:Turbo 不加载 .env,需框架加载,但要把 .env 加入 inputs 才会因变更失效缓存;仓库根部放置 .env 属于反模式。配置分层:共享配置放 globalEnv/globalDependencies,包级差异用各包 turbo.json 配合 extends: ["//"] 与 $TURBO_EXTENDS$,避免根 turbo.json 堆满 package#task 覆盖。限制与注意:--parallel 会绕过依赖图,不应使用;不要用 && 串联 turbo 任务;不要用 prebuild 手动构建依赖,先声明 workspace 依赖再交给 ^build;inputs 中不要用 ../ 跨包,应使用 $TURBO_ROOT$。资料提及 references/ 下更多细节文件(configuration、caching、filtering、environment、ci、watch、best-practices、boundaries 等),但未提供具体文件内容;未提供版本、收费与平台信息。
turborepo
通用与其它
更新于 10-16 07:22