turborepo

Turborepo 是 Vercel 推出的高性能 JavaScript/TypeScript 单体仓库构建系统，本 Skill 提供完整的配置指南与最佳实践。核心用法围绕 turbo.json 配置展开，开发者需定义任务管道明确构建依赖关系，通过 dependsOn 声明任务间的执行顺序，利用 ^build 语法确保依赖包先行构建。配合 --affected 标志可仅构建变更包及其下游依赖，显著减少 CI/CD 时间。远程缓存支持团队共享构建产物，避免重复计算。

显著优点包括：智能并行执行基于依赖图优化任务调度，大幅缩短构建时间；细粒度缓存机制精确追踪文件哈希与环境变量，实现"构建一次，处处可用"；与 pnpm/npm 工作区无缝集成，支持复杂 monorepo 架构。turbo watch 模式提供高效的开发体验，自动重编译变更依赖。

潜在局限性在于配置复杂度较高，初学者易混淆 ^build 与 build 的依赖语义，或错误配置 outputs 导致缓存失效。作为 T3 来源的社区文档，虽基于官方资料整理，但缺乏官方直接背书，部分边缘场景建议对照官方文档验证。严格的环境变量管理要求也增加了配置负担。

适合目标群体为中大型前端/全栈团队，特别是采用 Next.js、Node.js 技术栈且包含多个应用与共享包的 monorepo 架构。对构建速度敏感、CI 资源消耗大的工程团队收益最为显著。

使用风险主要包括：错误的缓存配置可能导致过时产物被复用，建议关键部署使用 --force 跳过缓存；环境变量未正确声明会导致缓存命中但运行时错误；远程缓存凭证管理不当存在泄露风险；过度依赖缓存可能掩盖依赖声明不完整等架构问题。