Turborepo

核心特性

Pipeline 任务依赖图如何配置？

Turborepo 通过 turbo.json 中的 pipeline 配置定义任务间的依赖关系。使用 ^ 符号表示依赖包的同名任务必须先完成。

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

本地缓存和远程缓存的区别？

• 本地缓存：存储在 node_modules/.cache/turbo，仅在当前机器可用，适合个人开发
• 远程缓存：部署在服务器或 Vercel 托管，团队共享缓存结果，CI/CD 也能受益
• 缓存键：基于文件内容哈希、环境变量、依赖版本计算，确保缓存准确性

如何配置 Turborepo 远程缓存？

1. 使用 Vercel 托管（推荐）：npx turbo login 登录后启用
2. 自托管远程缓存：使用 @turbo/remote 包搭建私有缓存服务器
3. CI/CD 集成：设置 TURBO_TOKEN 和 TURBO_TEAM 环境变量

# 本地登录并链接团队
turbo login
turbo link

最佳实践

如何避免幽灵依赖问题？

• 使用 pnpm 作为包管理器，其严格的 node_modules 结构天然避免幽灵依赖
• 启用 Turborepo 的 experimentalUI 和 strict 模式
• 在 package.json 中显式声明所有直接依赖，不依赖传递依赖

pnpm + Turborepo 的组合优势

• 磁盘效率：pnpm 的 content-addressable 存储节省磁盘空间
• 安装速度：pnpm 比 npm/yarn 更快的依赖安装
• 严格依赖：pnpm 的 hoisting 控制避免幽灵依赖
• Workspace 协议：pnpm workspaces 与 Turborepo 无缝集成

资源

• Turborepo 官方文档
• Turborepo 远程缓存指南
• Monorepo Handbook