团队 Git 分管理全流程规范

热门资讯 2025年09月09日 10:39 1 admin

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

1. 分支模型

团队 Git 分管理全流程规范

本 Git 管理方案采用基于 Git Flow 的简化分支模型，主要包含以下分支类型：

| 分支类型 | 说明 | | ---

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 回滚