返回文章

Git 分支管理:四种工作流与交互式选型

梳理 GitFlow、GitHub Flow、GitLab Flow 与主干开发的分支职责、发布路径和适用约束,通过交互式拓扑逐步理解代码如何进入生产。

Git 分支策略要解决三个问题:开发中的改动放在哪里,什么条件下可以集成,以及经过验证的代码如何进入生产。目标是隔离代码变更、保障发布稳定,并缩短多人协作时的分歧时间。

分支负责组织代码历史。开发、预发与生产的运行环境是否隔离,还取决于部署、配置、数据和权限,不能只靠几个分支名实现。

下面介绍四种常见模型:GitFlow、GitHub Flow、GitLab Flow 和 Trunk-Based Development(主干开发,简称 TBD)。它们解决问题的侧重点不同;选型应从发布方式与验证约束出发。

四种分支模型

GitFlow:围绕版本组织开发与发布

GitFlow 用明确的分支职责管理版本周期。它有两条长期分支,以及三类临时分支。

分支从哪里创建职责与去向
main(早期也称 master)长期分支保存生产就绪的版本,正式发布时标记版本 Tag
develop长期分支集成下一版本已经完成的开发成果
feature/*develop开发新功能,完成后合回 develop
release/*develop验证待发布版本、修复发布问题,完成后合入 main,并将修复合回 develop
hotfix/*main修复生产问题,完成后合入 main 并同步开发线

常规发布路径是:功能先进入 develop,版本准备好后创建 release/*,验证通过再进入 main。发布分支中的修复需要回到 develop,避免下一版本遗漏。

热修复从生产 main 创建,避免带入尚未发布的功能。通常需要合回 main 和 develop;如果此时有活跃的发布分支,原始模型要求将修复同步到该 release/*,随后随发布分支回到 develop。

这种流程适合有明确版本周期、发布冻结或多个已发布版本维护需求的产品。代价是分支之间的同步与合并工作较多。GitFlow 的原始模型说明也已补充:持续交付的 Web 应用通常应考虑更简单的工作流。

GitHub Flow:围绕一条可部署主线协作

GitHub Flow 只有一条长期主线,通常命名为 main。新功能和缺陷修复都通过任务分支完成。

  1. 从 main 创建名称清楚的任务分支,例如 feat/user-login。
  2. 在分支上提交并推送改动,保持任务聚焦。
  3. 发起 Pull Request(PR),收集反馈、完成代码审查与必要检查。
  4. 满足仓库的合并要求后合入 main,完成发布流程,再删除不再使用的任务分支。

main 应保持可部署,但合并成功不等于部署成功。“合并到 main 后自动部署”是常见的 CI/CD 配置,并非分支模型本身保证的行为;团队也可以在合并前通过预览部署验证变更。GitHub Flow 官方说明描述了分支、PR、审查与合并的协作路径。

它适合围绕一条主线持续交付的 SaaS、Web 应用与开源项目。结构简单,也意味着发布门禁主要由审查、测试与部署流水线承担。

GitLab Flow:连接主线开发与发布约束

GitLab Flow 直接围绕 main 开发,并结合 Issue、Merge Request(MR)及发布流程。它可以使用环境分支,也可以使用版本分支;环境分支并非唯一形式。

采用环境分支时,一条常见路径是:

feat/* → main → staging → production

功能和修复先进入 main,通过集成验证后晋级到 staging;预发验证通过,再推进 production,由相应流水线部署。

“上游优先”(Upstream First)强调修复先回到主线,再传播到需要它的下游,避免只在生产或旧版本分支修复、后续版本却丢失修复。维护已发布版本时,也可以使用 release/2.3 这类版本分支,将适用的修复移植过去,而不是让旧版本接收主线全部新功能。GitLab Flow 说明介绍了环境分支与版本分支两种组织方式。

这适合需要清楚表达环境晋级或版本维护关系的团队。分支和环境如何对应、何时部署、由什么检查阻止晋级,都需要在流水线中明确定义。

主干开发:缩短代码分歧的时间

主干开发围绕一条共享主干持续集成小批量变更。小团队可以直接向主干提交,也可以保留 PR 与生命周期很短的任务分支。

判断关键是集成频率,而不只是仓库里有没有分支。主干开发实践说明强调频繁回到主干;短分支实践通常将分支寿命控制在一天内或一两天,等待审查的时间也包含在内。

较大功能可以拆成可发布的小步骤,或使用 Feature Flags(特性开关)隐藏尚未开放的能力,让“代码已经集成”与“功能向用户开放”分开。使用开关时要验证相关状态,并在功能稳定后清理开关与废弃路径。

主干开发要求快速 CI、及时审查与小步拆分。它通过缩短分歧时间降低集成成本,仍然需要处理冲突和语义层面的集成问题。主干开发也不必然意味着每次集成都立即发布;发布频率和是否使用短期发布分支,仍取决于产品约束。

横向比较与选型

下表比较的是常见实践形态。发布频率与自动化水平由团队建立,不能仅从模型名称推断。

维度GitFlowGitHub FlowGitLab Flow主干开发(TBD)
分支结构main、develop 与三类临时分支main 与任务分支main 与环境或版本分支一条主干与极短任务分支
集成节奏功能先集成到 develop经 PR 合入 main经 MR 合入 main,再向下游推进每天或更频繁地回到主干
常见发布方式按版本准备与发布围绕主线持续交付按环境门禁或版本计划推进保持可发布,按需要开放功能
关键验证能力发布分支验证、修复同步PR 检查、可部署主线主线验证、环境晋级门禁快速 CI、及时审查、小批量变更
常见适用约束明确版本周期与版本维护单主线、高频交付环境晋级或版本维护关系明确能持续拆小任务并快速验证
主要成本多分支同步与较长集成路径发布流程依赖可靠的门禁环境或版本分支之间的同步验证速度、任务拆分与开关治理

先确定是否需要维护多个已发布版本、是否必须逐级晋级环境、主线能否始终可发布,再看 CI 与审查能否支持目标集成频率。团队人数本身不能决定答案。

GitHub Flow 与主干开发也可能重叠:如果任务分支足够短、PR 审查及时、每天都集成到主线,同一套协作方式可以同时具备两者的特征。

日常分支管理约定

统一命名,让分支表达任务

可以采用 <类型>/<描述> 或 <类型>/<单号>-<描述>。例如:

feat/1024-wechat-pay
fix/login-token-expired
hotfix/payment-crash
refactor/order-service

这些是团队约定,Git 不强制要求上述前缀。GitFlow 常见的 feature/* 和其他流程常见的 feat/* 应分别遵循所在项目的规则。

保护主分支,让要求真正生效

多人协作时,可以在 GitHub 或 GitLab 为主分支设置保护规则:要求通过 PR/MR、至少一位审查者批准,以及必要 CI 检查全部通过后才能合入;同时限制直接推送与绕过规则的权限。

具体要求属于团队政策,应在仓库设置中落实。GitHub 分支保护文档列出了审查、状态检查和部署检查等门禁。

同步主线与合入主线是两件事

在自己维护的任务分支上,工作区干净、且没有其他人依赖待重写的提交历史时,可以通过下面的命令将当前分支变基到远端 main:

git pull --rebase origin main

Rebase 会重新创建提交,适合整理个人任务分支;不要直接重写多人共同依赖的历史。发生冲突时,需要理解并解决冲突,再继续验证。Git Rebase 文档解释了它如何重放提交及改写历史。

合入主线时,如果一个任务应该成为一个完整提交,可以选择 Squash and Merge,将开发过程中的零碎提交整理为一条清楚的提交。它是仓库的历史管理选择,不应机械应用到所有长期分支之间的同步。GitHub 的合并方式说明介绍了不同方式的取舍。合并后的提交信息可以参考约定式提交指南。

任务完成后清理临时分支

任务已合并、后续发布不再需要该分支时,删除对应的远端和本地临时分支。main、develop、仍在使用的环境分支,以及仍承担版本维护职责的分支,不属于这次清理范围。

清理的是不再承担职责的分支引用。版本追踪应依赖提交、Tag 与发布记录,不能依靠长期堆积已经完成的任务分支。

交互式分支工作流

选择团队场景或分支模型,逐步观察分支创建、审查、合并和发布的关系。拓扑展示的是简化的流程关系,不是按比例绘制的 Git 提交图;所有操作只改变演示状态。

团队场景
分支策略
分支复杂度
低 · main 与任务分支
发布节奏
保持随时可部署
适用团队
围绕一条主线持续交付的团队

演示采用合入 main 后触发部署的常见路径。

mainfeat/*

实线表示已推进的路径,虚线表示后续路径。点击节点查看规则。

节点规则 · feat/pay-api

从 main 创建描述性分支,一条分支聚焦一个任务。分支可提前发起草稿 PR 来收集反馈。

步骤 1 / 4

从 main 创建描述性分支

从可部署的 main 创建 feat/* 或 fix/*,开始单一任务的开发。

核心优势
分支关系简单,审查、验证与合并围绕一个任务完成。
约束与代价
发布节奏依赖验证与部署流程;多版本维护需要另外明确版本政策。

选型时,关注每一次合并背后的验证条件,以及修复是否会进入所有需要它的后续版本。流程越清楚,团队越容易判断一段代码现在在哪里、还差什么验证、何时能够发布。

参考资料

  1. GitFlow 的原始模型说明
  2. GitHub Flow 官方说明
  3. GitLab Flow 说明
  4. 主干开发实践说明
  5. 短分支实践
  6. GitHub 分支保护文档
  7. Git Rebase 文档
  8. GitHub 的合并方式说明