---
URL: "/zh-CN/blog/2025-09/git-flow.html"
LLMS_URL: "/zh-CN/blog/2025-09/git-flow.md"
lastUpdated: true
commentabled: true
recommended: true
title: "团队 Git 分支管理全流程规范"
description: "团队 Git 分支管理全流程规范"
date:

pageClass: "blog-page-class"
cover: "/covers/platform.svg"
---

---
lastUpdated: true
commentabled: true
recommended: true
title: 团队 Git 分支管理全流程规范
description: 团队 Git 分支管理全流程规范
date: 2025-09-30 17:00:00 
pageClass: blog-page-class
cover: /covers/platform.svg
---

本文整理了一套基于 Git Flow 的简化分支管理方案，结合实际开发中的常见场景，配合 时序图 展示完整流程，帮助团队在多人协作开发中做到 规范统一、降低风险、快速响应。

## 分支模型 ##

本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` | 长期维护分支，用于旧版本的维护 |

## 分支命名规范 ##

**功能分支**：`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`

## 分支管理全流程示意 ##

### Feature 并行开发 ###

```mermaid
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 分支开发者 确认

### Feature 分支冲突处理流程 ###

```mermaid
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 并重新发起合并请求

### Release 流程与上线 Master ###

```mermaid
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，保证开发主干与生产环境一致

### Hotfix 紧急修复 ###

```mermaid
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，保证开发主干包含所有修复

### 回滚到历史版本 ###

```mermaid
sequenceDiagram
    autonumber
    participant Mast as Master
    participant Dev as Develop

    %% 回滚 master
    Mast->>Mast: 紧急回滚到 v1.0

    %% 同步 develop
    Mast->>Dev: 通知 develop 同步回滚

```

**要点总结**：

- 当生产环境出现 严重问题且修复不可行 时，master 通过 tag 回滚 到历史稳定生产版本
- 回滚完成后，开发团队需要 同步 develop，保证开发主干和生产一致
- 确保开发人员 不会基于已回滚的代码继续开发

### 长期维护分支 ###

```mermaid
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.完整流程图

```mermaid
%% 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 回滚
```