【工程化进阶】Lerna太慢？用 Turborepo + pnpm 打造拓扑级增量构建大仓

CDN3602026-06-14 11:38

兄弟们，如果你的团队还在用 Lerna 管理包含几十个包的 Monorepo，那你一定经历过每次提交都要干等五分钟构建的绝望。随着业务膨胀，Lerna 默认的串行构建和幽灵依赖（Phantom Dependencies）问题会把你逼疯。今天咱们就来聊聊，如何用 Turborepo 配合 pnpm workspace，实现按依赖关系编排的拓扑构建，让你的大仓开发体验原地起飞。

核心痛点：串行等待与缓存失效

Lerna 最大的问题是它不懂包之间的依赖图。哪怕包A和包B毫无关系，它也要按字母顺序一个一个 build。更致命的是，如果你只改了一行注释，它依然会把整个仓库从头到尾重新编译一遍，完全没有增量概念。此外，Lerna 默认的 hoisting（依赖提升）机制经常导致本地能跑、CI环境却报模块找不到的诡异Bug。

实战方案：声明式任务编排与极速隔离

1. 引入 Turborepo 进行拓扑排序

在根目录创建 turbo.json，明确声明任务的上下游依赖关系。例如，Web应用的 build 必须等待底层 UI 库的 build 完成。Turborepo 会自动分析依赖树，并行执行无关联的任务，构建速度呈指数级提升。

复制代码

1{
2  "$schema": "https://turbo.build/schema.json",
3  "pipeline": {
4    "build": {
5      "dependsOn": ["^build"], 
6      "outputs": ["dist/**"]
7    },
8    "test": {
9      "dependsOn": ["build"]
10    }
11  }
12}

2. 拥抱 pnpm workspace 杜绝幽灵依赖

抛弃 npm/yarn，全面切换至 pnpm。利用其硬链接和符号链接机制，严格遵循 package.json 中的声明。子包如果没有显式安装 dayjs，就绝对无法引用它，从根源上斩断了 CI 环境下的各种灵异报错。

总结：工欲善其事，必先利其器。放弃低效的串行脚本，拥抱 Turborepo 的声明式流水线，你的大型前端项目才能真正做到敏捷迭代！