Git-Flow与GitHub-Flow

1. 分支模型概述

1.1 为什么需要分支模型

分支模型定义了团队如何使用分支进行协作，核心解决：

• 如何组织功能开发
• 如何管理发布
• 如何处理热修复
• 如何保持主分支稳定

2. Git Flow

2.1 分支结构

main ────────────────────────────────────
  │                                      │
  └── release/1.0 ────┘                  │
       │            │                    │
develop ──────────────────────────────────
  │       │        │      │
  └─feature/A─┘    └─feature/B─┘

2.2 工作流程

# 1. 从 develop 创建功能分支
git checkout -b feature/auth develop

# 2. 开发并提交
git commit -m "feat: add login"

# 3. 完成后合并回 develop
git checkout develop
git merge --no-ff feature/auth
git branch -d feature/auth

# 4. 准备发布
git checkout -b release/1.0 develop
# 修复 Bug、更新版本号
git commit -m "chore: bump version to 1.0"

# 5. 合并到 main 和 develop
git checkout main
git merge --no-ff release/1.0
git tag -a v1.0.0
git checkout develop
git merge --no-ff release/1.0
git branch -d release/1.0

# 6. 热修复
git checkout -b hotfix/bug-123 main
git commit -m "fix: resolve critical bug"
git checkout main
git merge --no-ff hotfix/bug-123
git tag -a v1.0.1
git checkout develop
git merge --no-ff hotfix/bug-123
git branch -d hotfix/bug-123

2.3 Git Flow 工具

# 安装 git-flow
brew install git-flow        # macOS
sudo apt install git-flow    # Linux

# 初始化
git flow init

# 功能开发
git flow feature start auth
git flow feature finish auth

# 发布
git flow release start 1.0
git flow release finish 1.0

# 热修复
git flow hotfix start bug-123
git flow hotfix finish bug-123

3. GitHub Flow

3.1 分支结构

main ─────────────────────────────────────
  │        │            │               │
  └─feature/A──┘  └─feature/B──┘       │

3.2 工作流程

# 1. 从 main 创建分支
git checkout -b feature/auth main

# 2. 开发并提交
git commit -m "feat: add authentication"

# 3. 推送并创建 Pull Request
git push -u origin feature/auth
# 在 GitHub 上创建 PR

# 4. 代码审查
# 团队成员审查代码

# 5. 合并到 main
# 通过 GitHub 合并 PR
# 自动部署到生产环境

# 6. 删除分支
git branch -d feature/auth
git push origin --delete feature/auth

3.3 核心原则

• main 分支始终可部署
• 所有开发在功能分支进行
• 通过 Pull Request 进行代码审查
• 合并后立即部署

4. 模型对比

5. 其他模型

5.1 Trunk-Based Development

main ────────────────────────────────
  │  │  │  │  │  │  │  │  │  │
  频繁提交，小步前进
  功能开关控制未完成功能

• 所有开发者在 main 上直接提交
• 使用功能开关（Feature Flag）控制
• 极短的分支生命周期（<1天）
• 适合 CI/CD 成熟的团队

5.2 选型建议