8、版本控制与分支策略:Git Flow、Trunk Based Development、大型仓库(Monorepo vs Multi-repo)
版本控制这件事,说白了就是给代码上保险。我见过太多团队,一开始觉得「随便拉个分支就行」,结果上线前合并冲突能搞到凌晨三点。嗯,今天咱们就聊聊怎么选分支策略,以及仓库到底该不该拆。
8.1 分支策略:没有银弹,但有套路
先说说两种主流的分支模型。我个人习惯是,根据发布频率来选——你想想看,一个月发一次版和一天发十次版,能一样吗?
8.1.1 Git Flow:经典但有点重
Git Flow 是 2010 年 Vincent Driessen 提出的。它定义了五种分支:master、develop、feature、release、hotfix。结构清晰,但流程长。
核心流程:
master:只存发布过的代码,每个 commit 对应一个版本develop:日常开发的主干,feature 分支从这里拉feature/*:新功能开发,完成后合并回 developrelease/*:准备发布时从 develop 拉出,只修 bug,不添功能hotfix/*:线上紧急修复,从 master 拉,修完同时合并到 master 和 develop
我在一个嵌入式 C++ 项目里用过 Git Flow。那个项目三个月发一次版,客户对稳定性要求极高。Git Flow 的 release 分支给了我们充分的回归测试时间,hotfix 也能快速响应线上问题。但说实话,流程确实繁琐。有一次新同事忘了把 hotfix 合并回 develop,导致下个版本又把 bug 带出来了……嗯,后来我们加了 CI 检查才解决。
避坑指南:我曾经在团队里强制推行 Git Flow,结果大家每天花 10% 的时间在拉分支、合分支上。如果你的团队每天发布多次,Git Flow 会让你痛不欲生。
8.1.2 Trunk Based Development:快节奏团队的利器
Trunk Based Development(TBD)的理念很简单:所有开发者都在主干(trunk/main)上工作,分支存活时间不超过一天。说白了,就是「小步快跑,频繁合并」。
核心规则:
- 所有代码直接提交到主干,或者拉一个短命分支(< 24 小时)
- 每次提交都要通过 CI 测试
- 通过特性开关(Feature Flag)控制未完成的功能
我参与过一个日活千万级的后端服务,用的就是 TBD。团队 20 多人,每天合并 50+ 次。刚开始我挺慌的——「这么频繁合并,不会出事吗?」后来发现,只要 CI 够快、测试覆盖率够高,TBD 反而让冲突更少。因为每次改动都很小,合并起来几乎没成本。
我的建议:如果你的团队在 10 人以内,发布频率每天超过 1 次,优先考虑 TBD。但前提是——你必须有一套靠谱的 CI/CD 流水线,以及完善的特性开关机制。
8.2 大型仓库:Monorepo vs Multi-repo
仓库怎么放,这问题吵了十年了。我两边都踩过坑,说说真实感受。
8.2.1 Monorepo:一个仓库管所有
Monorepo 就是把所有项目代码放在一个 Git 仓库里。Google、微软、Uber 都在用。好处很明显:
- 代码复用方便:公共库改个接口,所有调用方立刻感知
- 原子提交:一次提交可以跨多个模块,回滚也简单
- 统一工具链:CI、代码规范、版本号全统一
但 Monorepo 也有代价。我记得在某个项目里,仓库克隆下来要 15 分钟,git status 都要等 3 秒。后来我们用了 Google 的 repo 工具和稀疏检出(sparse checkout)才缓解。
Monorepo 的 C++ 实践:
# 使用 CMake 的 add_subdirectory 管理子项目
project(MyMonorepo)
add_subdirectory(libs/common)
add_subdirectory(libs/network)
add_subdirectory(services/auth_service)
add_subdirectory(services/data_service)
# 公共头文件路径统一
target_include_directories(auth_service
PRIVATE
${CMAKE_SOURCE_DIR}/libs/common/include
)
8.2.2 Multi-repo:各管各的,互不干扰
Multi-repo 就是每个服务或组件一个仓库。微服务架构里很常见。优点:
- 独立迭代:每个团队只管自己的仓库,权限管理简单
- 仓库轻量:克隆快,操作快
- 技术栈自由:不同仓库可以用不同的构建系统
但 Multi-repo 的痛点也很明显——版本依赖管理。我曾经维护过一个 C++ 项目,依赖了 8 个内部库。每次升级某个库,都要手动改 8 个仓库的 CMakeLists.txt,然后等各自的 CI 跑完。有一次因为版本号没对齐,编译挂了整整两天。
避坑指南:我曾经在一个 Multi-repo 项目里,因为公共库改了 ABI,导致 5 个服务在发布后崩溃。从那以后,我要求所有公共库必须做 ABI 兼容性检查,并且用语义化版本号严格管理。
8.3 怎么选?一张表说清楚
| 维度 | Monorepo | Multi-repo |
|---|---|---|
| 团队规模 | 适合 50 人以上 | 适合 10 人以下小团队 |
| 发布频率 | 适合低频发布 | 适合高频独立发布 |
| 代码复用 | 天然支持,成本低 | 需要包管理工具 |
| 工具链 | 需要定制工具(如 Bazel) | 标准 Git 操作即可 |
| 权限管理 | 粒度粗,容易误操作 | 粒度细,安全可控 |
| CI 成本 | 需要增量构建,否则很慢 | 每个仓库独立 CI,简单 |
8.4 我的实战建议
说了这么多,到底怎么选?我个人的经验是:
- 小团队(< 10 人):用 Trunk Based Development + Multi-repo。简单直接,别整花活。
- 中型团队(10-50 人):用 Git Flow + Monorepo。流程规范,适合有稳定发布节奏的项目。
- 大型团队(> 50 人):用 Trunk Based Development + Monorepo + 特性开关。但必须配好增量构建和代码所有权机制。
最后说一句:没有完美的方案,只有适合的方案。我见过用 Git Flow 的团队天天加班合分支,也见过用 TBD 的团队因为测试覆盖率不够而频繁回滚。工具是死的,人是活的。选一个你们团队能坚持执行的,比选一个「理论上最优」的更重要。
嗯,版本控制这件事,说到底是为了让团队更高效地协作。别让工具成为负担,也别让流程变成枷锁。下次咱们聊聊 CI/CD 流水线怎么搭,那才是真正让分支策略落地的东西。