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/*:新功能开发,完成后合并回 develop
  • release/*:准备发布时从 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 我的实战建议

说了这么多,到底怎么选?我个人的经验是:

  1. 小团队(< 10 人):用 Trunk Based Development + Multi-repo。简单直接,别整花活。
  2. 中型团队(10-50 人):用 Git Flow + Monorepo。流程规范,适合有稳定发布节奏的项目。
  3. 大型团队(> 50 人):用 Trunk Based Development + Monorepo + 特性开关。但必须配好增量构建和代码所有权机制。

最后说一句:没有完美的方案,只有适合的方案。我见过用 Git Flow 的团队天天加班合分支,也见过用 TBD 的团队因为测试覆盖率不够而频繁回滚。工具是死的,人是活的。选一个你们团队能坚持执行的,比选一个「理论上最优」的更重要。

嗯,版本控制这件事,说到底是为了让团队更高效地协作。别让工具成为负担,也别让流程变成枷锁。下次咱们聊聊 CI/CD 流水线怎么搭,那才是真正让分支策略落地的东西。