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。新功能和缺陷修复都通过任务分支完成。
- 从
main创建名称清楚的任务分支,例如feat/user-login。 - 在分支上提交并推送改动,保持任务聚焦。
- 发起 Pull Request(PR),收集反馈、完成代码审查与必要检查。
- 满足仓库的合并要求后合入
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、及时审查与小步拆分。它通过缩短分歧时间降低集成成本,仍然需要处理冲突和语义层面的集成问题。主干开发也不必然意味着每次集成都立即发布;发布频率和是否使用短期发布分支,仍取决于产品约束。
横向比较与选型
下表比较的是常见实践形态。发布频率与自动化水平由团队建立,不能仅从模型名称推断。
| 维度 | GitFlow | GitHub Flow | GitLab 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 mainRebase 会重新创建提交,适合整理个人任务分支;不要直接重写多人共同依赖的历史。发生冲突时,需要理解并解决冲突,再继续验证。Git Rebase 文档解释了它如何重放提交及改写历史。
合入主线时,如果一个任务应该成为一个完整提交,可以选择 Squash and Merge,将开发过程中的零碎提交整理为一条清楚的提交。它是仓库的历史管理选择,不应机械应用到所有长期分支之间的同步。GitHub 的合并方式说明介绍了不同方式的取舍。合并后的提交信息可以参考约定式提交指南。
任务完成后清理临时分支
任务已合并、后续发布不再需要该分支时,删除对应的远端和本地临时分支。main、develop、仍在使用的环境分支,以及仍承担版本维护职责的分支,不属于这次清理范围。
清理的是不再承担职责的分支引用。版本追踪应依赖提交、Tag 与发布记录,不能依靠长期堆积已经完成的任务分支。
交互式分支工作流
选择团队场景或分支模型,逐步观察分支创建、审查、合并和发布的关系。拓扑展示的是简化的流程关系,不是按比例绘制的 Git 提交图;所有操作只改变演示状态。
- 分支复杂度
- 低 · main 与任务分支
- 发布节奏
- 保持随时可部署
- 适用团队
- 围绕一条主线持续交付的团队
演示采用合入 main 后触发部署的常见路径。
实线表示已推进的路径,虚线表示后续路径。点击节点查看规则。
从 main 创建描述性分支,一条分支聚焦一个任务。分支可提前发起草稿 PR 来收集反馈。
从 main 创建描述性分支
从可部署的 main 创建 feat/* 或 fix/*,开始单一任务的开发。
- 核心优势
- 分支关系简单,审查、验证与合并围绕一个任务完成。
- 约束与代价
- 发布节奏依赖验证与部署流程;多版本维护需要另外明确版本政策。
选型时,关注每一次合并背后的验证条件,以及修复是否会进入所有需要它的后续版本。流程越清楚,团队越容易判断一段代码现在在哪里、还差什么验证、何时能够发布。