CI/CD / 系统课时
建立分支与版本策略
建立分支与版本策略
分支策略的目标不是增加流程,而是让“正在开发、准备发布、已经发布”三种状态可追踪、可回退。本课给出一套可按团队规模裁剪的主干、功能分支、发布分支与版本标签规则,并用 Git 命令验证关键动作。
学习目标
- 能根据团队规模和发布节奏选择主干开发、功能分支或发布分支
- 能定义分支命名、合并和保护规则,避免长期分叉
- 能使用语义化版本标签标记可部署、可追溯的发布点
先选分支模型再写规则
小团队、高频发布的服务优先采用主干开发:开发者围绕 main 工作,变更保持小批量,并通过短生命周期分支完成评审。团队扩大后,可以保留 feature/* 作为隔离区,但应把“短生命周期”作为硬约束,而不是让功能分支演变成第二条主干。
只有当发布需要独立稳定窗口时,才增加 release/*。例如移动端审核、企业版交付或固定版本列车,需要在主干继续开发的同时冻结一个候选版本;持续部署的后端服务通常不需要长期发布分支。
| 模型 | 适合场景 | 主要收益 | 主要风险 |
|---|---|---|---|
| 主干开发 | 小团队、高频部署 | 分叉少、集成早 | 对自动化测试和小批量提交要求高 |
| 短功能分支 | 多人并行、需要评审 | 便于代码审查和权限控制 | 分支存活过久会增加合并成本 |
| 发布分支 | 需要独立稳定期 | 可冻结候选版本并只接收修复 | 维护多条线,容易漏回合并 |

把功能分支控制在一次变更内
功能分支应从最新 main 创建,只承载一个可以独立评审和回滚的变更。名称使用稳定前缀,例如 feature/、fix/、chore/,后缀表达任务而不是人员姓名。合并后立即删除远端分支,避免后续提交继续落到已经完成的工作线上。
下面的命令在一个已有 Git 仓库中创建短功能分支,并确认当前分支名:
git switch -c feature/payment-timeout
git branch --show-current预期输出:
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 这类预发布标识。
下面在当前提交上创建正式发布标签,并验证标签已经存在:
git tag -a v2.4.0 -m "release v2.4.0"
git tag --list "v2.4.0"预期输出:
v2.4.0把分支策略落实成仓库门禁
策略只有写进仓库权限和流水线才真正生效。main 至少应禁止直接推送,要求 Pull Request、必要评审和必需状态检查通过后才能合并;是否要求线性历史可按团队习惯决定,但不要允许绕过测试的紧急合并成为常态。
发布分支应限制创建者和合并权限,正式版本标签只允许发布角色创建。流水线构建制品时,把提交 SHA 与版本标签同时写入制品元数据,部署记录同时保存二者,这样即使后续出现补丁分支,也能准确回答“线上版本来自哪次提交”。
当团队是持续部署的后端服务,最小可行方案通常是“受保护的 main + 短功能分支 + 不可变版本标签”;只有出现明确的独立稳定期,才引入 release/*。分支越少越好,但每一种保留下来的分支都必须对应清晰的生命周期和权限边界。