Lerna vs Nx vs Turbo：单体仓库工具深度对比

在现代前端工程中，单体仓库（monorepo）已成为管理多个相互关联包或应用的标准实践。lerna、nx 和 turbo 是当前主流的三大工具，但它们解决的问题、适用场景和底层机制大不相同。本文从真实开发视角出发，深入比较三者的核心能力。

📦 核心定位：包管理器 vs 工程平台 vs 构建加速器

lerna 最初是为 npm 包发布而设计的，核心功能是 版本管理和发布流程自动化。它假设你已有一个基于 Yarn 或 npm workspaces 的 monorepo，并在此基础上添加 lerna version 和 lerna publish 等命令。

// lerna.json
{
  "version": "independent",
  "packages": ["packages/*"]
}

nx 是一个 全功能工程平台，不仅处理任务执行，还提供依赖图分析、代码生成、测试覆盖率报告、影响范围计算（affected projects）等一整套开发工作流。它自带构建系统（可集成 Webpack、Vite 等），也支持非 JavaScript 项目。

// nx.json
{
  "targetDefaults": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["production", "^production"]
    }
  }
}

turbo 本质上是一个 高性能任务调度器，不关心你的构建工具是什么（Webpack、Vite、esbuild 都可以），只负责 并行执行任务 + 智能缓存结果。它的配置极其简洁，重点在于定义任务之间的依赖关系。

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

⚙️ 任务执行与缓存机制

任务依赖定义

三者都支持通过 ^ 表示“依赖于其他包的同名任务”，但语法和能力不同。

lerna 使用命令行参数指定依赖，功能较弱：

# lerna: 手动指定哪些包要运行
lerna run build --scope=app-web --include-dependencies

nx 在 project.json 或 package.json 中为每个项目定义 targets，并支持复杂的依赖链：

// apps/web/project.json
{
  "targets": {
    "build": {
      "executor": "@nx/vite:build",
      "dependsOn": ["^build"]
    }
  }
}

turbo 在全局 turbo.json 中声明 pipeline，简洁直观：

// turbo.json
{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!./node_modules/**"]
    }
  }
}

缓存策略

lerna 没有内置缓存机制。每次运行 lerna run 都会重新执行所有匹配的任务，即使输入未变。这是它在大型项目中性能较差的主要原因。

nx 提供 本地 + 远程缓存，基于任务输入（源码、配置、环境变量等）生成哈希值。只有输入变化时才重新执行任务。

# nx: 自动跳过未变更项目的任务
nx build app-web
# 如果 app-web 及其依赖未变，直接命中缓存

turbo 同样基于输入哈希实现缓存，且原生支持 Vercel Remote Cache，团队成员可共享缓存结果。

# turbo: 自动复用缓存
npx turbo run build
# 输出类似：cache hit, saved 12.3s

🧩 依赖图与影响分析

当修改一个共享库时，如何知道哪些应用会受影响？这是 monorepo 工具的关键能力。

lerna 无法自动分析依赖关系。你必须手动指定 --scope 或 --ignore，容易出错。

nx 内置强大的依赖图引擎，可通过命令查看影响范围：

# nx: 查看受最近提交影响的项目
nx affected:apps
nx affected:build

# 可视化依赖图
nx graph

turbo 也支持影响分析，但需配合 Git 使用：

# turbo: 构建自上次提交以来变更过的项目及其依赖
npx turbo run build --filter="[HEAD]"

🛠️ 开发体验与生态系统

lerna 几乎不提供额外工具。你需要自己配置 ESLint、TypeScript、测试框架等。适合“最小干预”哲学的团队。

nx 提供 插件化生态系统（@nx/react, @nx/node, @nx/express 等），每个插件包含预设的构建器、代码生成器和最佳实践配置。例如：

# nx: 自动生成带测试和 Storybook 的 React 组件
nx g @nx/react:component --name=Button --project=ui-lib

turbo 保持 零侵入性，不强制任何项目结构或工具链。你只需在 package.json 中定义 scripts，然后用 turbo run 替代 npm run。

// package.json
{
  "scripts": {
    "build": "vite build",
    "dev": "vite"
  }
}

🌐 远程缓存与 CI 集成

lerna 无远程缓存支持。

nx 支持自建远程缓存（通过 nx-cloud 或开源方案），但配置较复杂。

turbo 原生集成 Vercel Remote Caching，只需设置环境变量即可启用：

# CI 环境中
TURBO_TOKEN=xxx TURBO_TEAM=yyy npx turbo run build

对于使用 Vercel 的团队，这是巨大优势。

📊 总结：关键能力对比

💡 如何选择？

• 选 lerna：如果你只维护一组 npm 包，且主要痛点是 版本发布和 changelog 生成，不需要复杂的任务缓存或依赖分析。
• 选 nx：如果你的 monorepo 包含 多个应用 + 共享库 + 后端服务，需要统一的工程规范、代码生成、依赖可视化和深度缓存，愿意接受一定学习成本。
• 选 turbo：如果你已有 monorepo 结构，但 构建太慢，希望用最小改动获得 极速缓存和并行执行，尤其团队使用 Vercel 时。

重要提示：lerna 目前仍处于维护状态（截至 2024 年），但官方推荐新项目考虑 nx 或 turbo。对于全新项目，除非你明确只需要发布功能，否则不建议首选 lerna。

最终，工具只是手段。选择那个能让你团队 写更少配置、跑更快构建、花更少时间调试依赖问题 的方案，才是真正的生产力提升。