Monorepo

定义

Monorepo(单一代码库)是一种代码组织策略,指将多个相关联的项目、应用或可复用的包集中存放于同一个版本控制仓库中统一管理,与之相对的是每个项目独立成库的 Polyrepo(多代码库)模式。[1]

原理

Monorepo 通过工作区(workspace)机制将仓库内的多个包关联起来,包之间可直接以本地依赖方式相互引用,而无需经由包注册中心发布。配套的任务编排工具会基于包间的依赖图分析变更影响范围,只对受影响的包执行构建、测试与发布,并借助内容哈希缓存复用历史构建结果,从而在大型代码库中保持可接受的构建效率。

特点

优点包括:跨项目的代码共享与原子化提交更为便利;依赖版本可统一治理,避免版本碎片化;重构、批量修改与一致的工程规范更易落地。缺点在于:仓库体积会随规模膨胀,克隆与拉取成本上升;权限粒度控制更复杂;若缺乏增量构建与缓存的支撑,CI 时长容易失控。

应用

常用工具包括 Nx、Turborepo、Lerna,以及包管理器自带的工作区能力(pnpm、Yarn、npm workspaces);Bazel 则面向超大规模场景。Monorepo 广泛见于需要在前后端、多应用与共享组件库之间频繁协作的团队,Google、Meta 等公司均采用大规模单库实践。是否采用应权衡团队规模、协作密度与工具链投入。