本文整理了一套基于 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 回滚