本文整理了一套基于 Git Flow 的简化分支管理方案，结合实际开发中的常见场景，配合 时序图 展示完整流程，帮助团队在多人协作开发中做到 规范统一、降低风险、快速响应。
1. 分支模型
本Git管理方案采用基于 Git Flow 的简化分支模型，主要包含以下分支类型：
| 分支类型 | 说明 |
|---|---|
master | 生产环境分支，始终保持稳定，仅通过合并release或hotfix分支更新 |
develop | 开发整合分支，集成所有已完成的功能，用于日常开发集成 |
feature/xxx | 新功能开发分支，基于develop创建，开发完成后合并回develop |
release/x.x.x | 预发布分支，用于测试、修复和准备发布 |
bugfix/xxx | Release 阶段发现的 Bug 修复分支，用于临时修复 Release 问题 |
hotfix/xxx | 紧急修复分支，用于快速修复master上的生产问题 |
support/x.x | 长期维护分支，用于旧版本的维护 |
2. 分支命名规范
功能分支：feat/模块名-功能描述
例：feature/login-page、feature/user-profile-edit
Release 阶段 Bug 修复分支：bugfix/问题描述
例：bugfix/login-button-fix
生产环境 紧急 Bug 修复分支：hotfix/问题描述
例：hotfix/login-bug
预发布分支：release/版本号
例：release/1.2.0
长期维护分支：support/版本号
例：support/1.x
3.分支管理全流程示意
3.1 Feature 并行开发
sequenceDiagram
autonumber
participant FeatA as Feature-A
participant FeatB as Feature-B
participant Dev as Develop
%% Feature 提交合并请求
FeatA->>Dev: 提交 Feature-A 合并请求
FeatB->>Dev: 提交 Feature-B 合并请求
%% Develop 执行合并
Dev->>Dev: 合并 Feature-A 到 develop
Dev->>Dev: 合并 Feature-B 到 develop
要点总结：
- 每个开发人员在自己的 feature 分支 上独立开发新功能
- 完成功能后，通过 Pull Request 提交到 develop 分支
- CI/CD 或团队负责人 在 develop 分支执行合并
- 合并完成后，反馈给 feature 分支开发者 确认
3.2 Feature 分支冲突处理流程
sequenceDiagram
autonumber
participant Dev as 开发者
participant Feat as Feature/xxx
participant Devel as Develop
participant Git as Git 平台
%% 开发
Dev->>Feat: 创建 feature/xxx 分支
%% 提交合并请求
Feat->>Git: 发起合并到 develop
Git->>Dev: 提示存在冲突（虚线）
%% 冲突解决
Dev->>Devel: 拉取最新 develop
Dev->>Feat: 合并 develop 到 feature/xxx
Dev->>Dev: 手动解决冲突并测试
Dev->>Feat: 推送解决后的代码
%% 再次合并
Feat->>Git: 重新发起合并请求
Git->>Devel: 成功合并到 develop
要点总结：
- 冲突必须由 功能分支的开发者 自行解决，不能把冲突推给 集成分支
- 解决冲突的正确方式是：在 feature 分支合并 develop，而不是强行修改 develop
- 解决后再 push 并重新发起合并请求
3.3 Release 流程与上线 Master
sequenceDiagram
autonumber
participant Dev as Develop
participant Rel as Release
participant Bug as Bugfix/xxx
participant Mast as Master
%% 创建 release
Dev->>Rel: 创建 release/v2.0
%% QA 测试反馈
Rel--)Dev: QA 测试反馈
%% -------- Release 阶段发现 Bug --------
Rel->>Bug: 创建 bugfix/xxx
Bug->>Bug: 修复 bug 并测试
Bug->>Rel: 合并 bugfix 回 release
Rel--)Dev: QA 验证修复
%% 上线 master
Rel->>Mast: 合并 release 到 master
Mast->>Mast: 打 tag v2.0
Mast->>Dev: 同步 master 到 develop
要点总结：
- 从 develop 创建 release 分支 进行集成测试和预发布
- Release 阶段发现 Bug → 创建 bugfix 分支修复 → 合并回 Release → QA 验证
- Release 分支合并到 master 后 打 Tag，用于 正式上线并保留上线版本记录
- master 的更新 必须同步回 develop，保证开发主干与生产环境一致
3.4 Hotfix 紧急修复
sequenceDiagram
autonumber
participant Mast as Master
participant HF as Hotfix
participant Dev as Develop
%% 创建 hotfix
Mast->>HF: 创建 hotfix/v2.0.1
%% 修复 bug
HF->>HF: 修复线上 bug
HF->>Mast: 合并回 master
%% 同步 develop
HF->>Dev: 合并 hotfix 到 develop
要点总结：
- 生产环境出现 紧急问题 时，从 master 创建 hotfix 分支 快速修复
- 修复完成后，合并回 master 并 打 Tag，触发上线
- 同时合并回 develop，保证开发主干包含所有修复
3.5 回滚到历史版本
sequenceDiagram
autonumber
participant Mast as Master
participant Dev as Develop
%% 回滚 master
Mast->>Mast: 紧急回滚到 v1.0
%% 同步 develop
Mast->>Dev: 通知 develop 同步回滚
要点总结：
- 当生产环境出现 严重问题且修复不可行 时，master 通过 tag 回滚 到历史稳定生产版本
- 回滚完成后，开发团队需要 同步 develop，保证开发主干和生产一致
- 确保开发人员 不会基于已回滚的代码继续开发
3.6 长期维护分支
sequenceDiagram
autonumber
participant Mast as Master
participant Sup as Support-1.x
participant HF as Hotfix
participant Dev as Develop
%% 生产环境发现 bug
Mast->>HF: 生产环境 bug，创建 hotfix/issue-123
%% Hotfix 修复
HF->>HF: 修复 bug
HF->>Sup: 合并回长期维护分支 support/1.x
HF->>Mast: 合并回 master
HF->>Dev: 合并回 develop
要点总结：
- 已发布的旧版本维护一个 长期维护分支 support/1.x
- 生产环境发现 bug 时，从 master 创建 hotfix 分支 进行修复
- 修复完成后，必须合并到：
- master（生产环境）
- support 分支（保证旧版本客户可用）
- develop（保持开发主干一致）
4.完整流程图
%% Git Flow 简化泳道图（不含 support，Release Bug 修复使用独立分支）
sequenceDiagram
autonumber
participant Feat as Feature/xxx
participant Dev as Develop
participant Rel as Release/x.x.x
participant Bug as Bugfix/xxx
participant Mast as Master
participant HF as Hotfix
%% ================= Feature 并行开发 =================
Feat->>Dev: 提交功能合并请求
Dev->>Dev: 合并 Feature 到 develop
%% ================= Feature 冲突处理 =================
Feat->>Dev: 拉取最新 develop
Feat->>Feat: 解决冲突并测试
Feat->>Dev: 推送并重新发起合并请求
Dev->>Dev: 成功合并
%% ================= Release 流程 =================
Dev->>Rel: 创建 release/x.x.x
Rel--)Dev: QA 测试反馈
%% -------- Release 阶段发现 Bug --------
Rel->>Bug: 从 release 创建 bugfix/xxx
Bug->>Bug: 修复 bug 并测试
Bug->>Rel: 合并 bugfix 回 release
Rel--)Dev: QA 验证修复
%% -------- Release 发布到生产 --------
Rel->>Mast: 合并 release 到 master
Mast->>Mast: 打 tag
Mast->>Dev: 同步 master 到 develop
%% ================= Hotfix 紧急修复 =================
Mast->>HF: 创建 hotfix/x.x.x
HF->>HF: 修复生产问题
HF->>Mast: 合并回 master 并打 Tag
HF->>Dev: 合并回 develop
%% ================= 回滚历史版本 =================
Mast->>Mast: 紧急回滚到历史版本
Mast->>Dev: 同步 develop 回滚
