Turborepo 单体仓库构建系统

单体仓库构建的核心痛点

在 JavaScript/TypeScript 单体仓库中，随着项目数量增加，构建、测试和任务编排会面临三大典型问题：重复计算（多个子项目修改依赖后，未变更的项目仍被重新构建）、串行等待（无依赖关系的任务被强制按顺序执行，浪费计算资源）、缓存断层（本地缓存仅在单台开发机生效，团队成员间无法复用已完成任务的结果）。这些问题会导致开发反馈周期变长，尤其在 CI/CD 流水线中，冗余执行会显著拖慢发布节奏。

核心能力与工作逻辑

该技能基于 Turborepo 实现，核心能力围绕「任务编排」与「缓存复用」展开：

• 智能本地缓存：通过记录每个任务的输入文件（如源码、配置文件）和执行命令，生成唯一缓存键（hash），下次执行时若输入未变更则直接复用缓存结果，避免重复构建。
• 并行任务调度：自动分析任务间的依赖关系（如 build 任务依赖 lint），构建无依赖的「并行执行图」，让可同时运行的任务在多核环境中并行执行，缩短总耗时。
• Vercel 远程缓存共享：支持将任务结果同步至 Vercel 远程缓存，团队成员或 CI 环境执行相同任务时，可直接拉取远程缓存，实现跨设备、跨团队的结果复用。

工作逻辑分为三步：① 解析单体仓库中各子项目的 package.json 与任务定义；② 根据任务依赖关系生成执行计划；③ 执行时先检查缓存（本地/远程），未命中则执行任务并写入缓存，最终输出结果。

适用边界与注意事项

• 适用场景：仅支持 JavaScript/TypeScript 单体仓库，需项目已配置 turbo.json 定义任务流程。
• 远程缓存前提：使用 Vercel 远程缓存需关联 Vercel 账号，且项目需托管在 Vercel 平台或支持其缓存协议的环境中。
• 自定义限制：复杂任务（如涉及非文件输入、动态依赖）可能需要手动调整缓存键规则，避免因缓存误判导致结果异常。