用途:为单仓库(monorepo)配置 Turborepo,提升构建效率,涵盖本地缓存与远程缓存、流水线编排、CI 性能优化、从其他单仓库工具迁移以及缓存未命中排查。
主要能力:定义 turbo.json 流水线,使用 dependsOn、cache、outputs、inputs、persistent 等字段控制任务依赖、缓存输出与影响缓存键的输入;支持包级 turbo.json 通过 extends 继承根配置;支持 globalDependencies、globalEnv 设置全局依赖与环境变量;支持按包、按目录、按变更范围过滤任务;支持远程缓存(Vercel 远程缓存与自建 Express 缓存服务,端点形如 /v8/artifacts/:hash);提供缓存调试手段,如 --dry-run、--verbosity=2、--graph、--force、--summarize 以及 TURBO_LOG_VERBOSITY=debug。
使用方式:根 package.json 声明 workspaces 与 turbo 依赖,脚本用 turbo build 等命令;远程缓存先执行 npx turbo login、npx turbo link,再以 turbo build --remote-only 运行,CI 中设置 TURBO_TOKEN 与 TURBO_TEAM;过滤示例包括 turbo build --filter=@myorg/web、--filter=@myorg/web...、--filter=...@myorg/ui、--filter='...[origin/main]'、--filter='./apps/*'、--filter='!@myorg/docs'。
适用场景:新建 Turborepo 项目、优化构建流水线、接入远程缓存、加快 CI/CD、迁移既有单仓库、定位缓存失效问题。
限制:资料中的自建缓存示例不做鉴权,官方提示仅可在受信机器上处理可丢弃产物且不要对外暴露该服务;开发服务器不应缓存,需设置 persistent: true;环境变量不应放入密钥,应使用运行时环境变量;不要忽略 dependsOn,否则可能产生竞态;过滤不宜过度,否则可能遗漏依赖。