Turborepo 怎么用？和 Nx、Lerna 有什么区别？

Question

仓乃文 · Accepted Answer

Monorepo 工具选型直接影响构建效率和开发体验。Turborepo 的核心卖点是任务缓存和并行执行，Nx 的卖点是依赖图分析和智能调度，Lerna 已经式微。2025 年主流组合是 pnpm workspace + Turborepo。

工具对比：
```
| 维度           | Turborepo       | Nx              | Lerna          |
|---------------|-----------------|-----------------|----------------|
| 核心能力       | 任务缓存+并行    | 依赖图+智能调度   | 包版本管理      |
| 学习曲线       | 低              | 高              | 低             |
| 构建缓存       | 本地+远程        | 本地+远程        | 无             |
| 依赖分析       | 基础             | 深度（受影响分析）| 无             |
| 生态成熟度     | 中              | 高              | 低（已归档）    |
| 适合规模       | 中小型           | 大型            | 任何           |
| 维护状态       | 活跃            | 活跃            | 社区维护       |
```

Turborepo 快速上手：
```bash
pnpm add -D turbo
```

turbo.json 配置：
```json
{
  "$schema": "https://turbo.build/schema.json",
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"],
      "cache": true
    },
    "test": {
      "dependsOn": ["build"],
      "outputs": [],
      "cache": true
    },
    "lint": {
      "outputs": []
    },
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}
```

常用命令：
```bash
# 构建所有包（自动并行+缓存）
turbo build

# 只构建变更的包
turbo build --filter=...[HEAD^]

# 运行特定包的命令
turbo dev --filter=web

# 强制跳过缓存
turbo build --force
```

补充说明：
- dependsOn: ["^build"] 表示先构建依赖包，再构建当前包
- 缓存命中时构建时间从分钟级降到秒级
- 远程缓存需要 Vercel 账号，免费版有额度限制
- Nx 更适合超大型项目（100+ 包），中小项目用 Turborepo 更简单