一、核心分支类型
1.主分支(Main/Master)
生产环境唯一基准,仅通过合并 release/hotfix 分支更新,禁止直接修改代码。
每次上线后需打版本标签(Tag),记录变更内容及时间。
2. 开发分支(Develop)
集成最新开发成果,作为功能开发的基线分支,始终保持可联调状态。
所有 feature 分支均需从此分支检出。
3.临时分支
特性分支(Feature):以 feature/ 为前缀,附加功能模块名称(如 feature/user-auth)。
修复分支(Bugfix/Hotfix):普通缺陷修复使用 bugfix/ 前缀;线上紧急问题使用 hotfix/ 前缀,需从 master 分支直接创建。
发布分支(Release):以 release- 加版本号命名(如 release-v1.2.0),用于预发布环境测试及小范围修复。
二、分支命名规范
1.统一前缀标识
特性分支:feature/功能模块(例:feature/payment-gateway);
修复分支:bugfix/问题描述 或 hotfix/紧急问题描述;
发布分支:release-版本号(例:release-v2.3.1)。
2.禁止事项
禁止使用无意义命名(如 branch1、test);
禁止包含特殊字符(如 &)。
三、分支管理流程
1.开发阶段
新功能开发需从 develop 分支创建 feature 分支;
多人协作时,feature 分支需推送至远端仓库。
2.测试与发布
release 分支由 develop 或 hotfix 分支合并生成,用于预发布环境验证;
测试通过后,release 分支需合并至 master 和 develop 分支,并打版本标签。
3.缺陷处理
普通缺陷在对应 feature 分支修复;
线上紧急问题通过 hotfix 分支快速修复,并同步至 master 和 develop 分支。
四、提交与合并规则
1. 提交规范
单次提交仅包含一个功能或缺陷修改;
合并前需解决冲突,并同步主分支最新代码。
2.代码审查
所有分支合并至 develop/master 前需通过团队代码审查;
审查通过后方可执行合并操作。
五、生命周期管理
feature/release/hotfix 分支在合并后应及时删除;
长期未活跃分支(如超30天无提交)需定期清理
六、分支管理说明:
每个人拉自己独立分支,不允许把公共分支合并到自己分支