优化 Monorepo 构建速度：配置 Turborepo 本地与远程缓存

解决大型 Monorepo 项目构建缓慢的问题：通过配置 Turborepo 的 Pipeline 和远程缓存（Remote Caching），确保只有发生变更的代码被重新构建，极大提升开发与部署效率。

为什么需要这个技能

在 Monorepo 架构中，随着项目规模增加，全量构建的时间成本会线性增长。即使只修改了一个 UI 组件，传统的构建流程可能会重新编译所有应用。

Turborepo 通过“内容可寻址”的缓存机制，能够识别哪些任务已经运行过且输入未改变，从而直接跳过执行并复用之前的输出。掌握其缓存配置，可以将 CI 构建时间从几十分钟缩短至几分钟，实现真正的增量构建。

在 turbo.json 中定义任务的依赖关系（dependsOn）、输入文件（inputs）和输出目录（outputs）。

{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
    }
  }
}

通过 turbo login 连接到 Vercel 或指定自定义 API 地址，将本地缓存同步至云端。

# 登录并链接项目
npx turbo login
npx turbo link

# 使用远程缓存执行构建
turbo build --remote-only

使用 --filter 标志仅构建受影响的包及其依赖，避免不必要的计算。

# 仅构建自 main 分支以来发生变更的包及其依赖
turbo build --filter='...[origin/main]'

通过 --dry-run 或 --summarize 查看哪些任务命中缓存，确保配置正确。

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

暂无推荐