CI/CD / 系统课时

建立分支与版本策略

建立分支与版本策略

分支策略的目标不是增加流程,而是让“正在开发、准备发布、已经发布”三种状态可追踪、可回退。本课给出一套可按团队规模裁剪的主干、功能分支、发布分支与版本标签规则,并用 Git 命令验证关键动作。

学习目标

  • 能根据团队规模和发布节奏选择主干开发、功能分支或发布分支
  • 能定义分支命名、合并和保护规则,避免长期分叉
  • 能使用语义化版本标签标记可部署、可追溯的发布点

先选分支模型再写规则

小团队、高频发布的服务优先采用主干开发:开发者围绕 main 工作,变更保持小批量,并通过短生命周期分支完成评审。团队扩大后,可以保留 feature/* 作为隔离区,但应把“短生命周期”作为硬约束,而不是让功能分支演变成第二条主干。

只有当发布需要独立稳定窗口时,才增加 release/*。例如移动端审核、企业版交付或固定版本列车,需要在主干继续开发的同时冻结一个候选版本;持续部署的后端服务通常不需要长期发布分支。

模型 适合场景 主要收益 主要风险
主干开发 小团队、高频部署 分叉少、集成早 对自动化测试和小批量提交要求高
短功能分支 多人并行、需要评审 便于代码审查和权限控制 分支存活过久会增加合并成本
发布分支 需要独立稳定期 可冻结候选版本并只接收修复 维护多条线,容易漏回合并

主干、功能分支、发布分支与版本标签的关系

把功能分支控制在一次变更内

功能分支应从最新 main 创建,只承载一个可以独立评审和回滚的变更。名称使用稳定前缀,例如 feature/、fix/、chore/,后缀表达任务而不是人员姓名。合并后立即删除远端分支,避免后续提交继续落到已经完成的工作线上。

下面的命令在一个已有 Git 仓库中创建短功能分支,并确认当前分支名:

bash
git switch -c feature/payment-timeout
git branch --show-current

预期输出:

text
Switched to a new branch 'feature/payment-timeout'
feature/payment-timeout

如果一个功能分支需要持续数周,优先把功能拆成可关闭的增量,并用 Feature Flag 隔离未完成能力。长期分支会推迟真实集成,直到发布前才暴露冲突、接口漂移和测试缺口。

只在需要稳定窗口时创建发布分支

release/* 的职责是“稳定当前候选版本”,而不是继续承载新功能。分支创建后只允许缺陷修复、版本号调整和必要文档变更;任何修复都要同步回 main,否则下一版本可能重新出现已经修复的问题。

一个常见规则是从候选提交创建 release/2.4,通过回归后在最终提交上打标签。标签使用语义化版本 MAJOR.MINOR.PATCH:破坏兼容性提升 MAJOR,向后兼容的新功能提升 MINOR,向后兼容的修复提升 PATCH。候选版可使用 v2.4.0-rc.1 这类预发布标识。

下面在当前提交上创建正式发布标签,并验证标签已经存在:

bash
git tag -a v2.4.0 -m "release v2.4.0"
git tag --list "v2.4.0"

预期输出:

text
v2.4.0

把分支策略落实成仓库门禁

策略只有写进仓库权限和流水线才真正生效。main 至少应禁止直接推送,要求 Pull Request、必要评审和必需状态检查通过后才能合并;是否要求线性历史可按团队习惯决定,但不要允许绕过测试的紧急合并成为常态。

发布分支应限制创建者和合并权限,正式版本标签只允许发布角色创建。流水线构建制品时,把提交 SHA 与版本标签同时写入制品元数据,部署记录同时保存二者,这样即使后续出现补丁分支,也能准确回答“线上版本来自哪次提交”。

当团队是持续部署的后端服务,最小可行方案通常是“受保护的 main + 短功能分支 + 不可变版本标签”;只有出现明确的独立稳定期,才引入 release/*。分支越少越好,但每一种保留下来的分支都必须对应清晰的生命周期和权限边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立分支与版本策略

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通