Git 分支管理与合并策略实战指南

注意 --no-ff 参数表示禁用快进模式。禁用后合并会创建新 commit，因此建议加上 -m 参数写明描述。

合并后查看分支历史：

git log --graph --pretty=oneline --abbrev-commit

可以看到，不使用 Fast Forward 模式，合并记录就像如下结构：

所以在合并分支时，加上 --no-ff 参数可以用普通模式合并，合并后的历史有分支，能看出来曾经做过合并，而 fast forward 合并就看不出来。

二、分支策略

在实际开发中，我们应该遵循几个基本原则进行分支管理：

1. Master 分支：应该是非常稳定的，仅用来发布新版本，平时不能在上面干活。
2. Dev 分支：日常开发都在 dev 分支上进行。
3. 合并流程：dev 分支是不稳定的，到某个时候（比如 1.0 版本发布时），再把 dev 分支合并到 master 上，在 master 分支发布 1.0 版本。

你和你的小伙伴们每个人都在 dev 分支上干活，每个人都有自己的功能分支，时不时地往 dev 分支上合并就可以了。团队合作的分支结构通常如下：

三、六种合并策略

1. 合并策略全景图

根据统计，Recursive 策略使用频率最高（约 45%），其次是 Fast Forward（30%），其余如 Ours/Theirs、Octopus、Subtree、Resolve 等策略在特定场景下各有应用。

2. 六大合并策略详解

① Fast Forward（快进合并）

• 触发条件：目标分支没有新提交。
• 命令示例：

  git merge --ff-only dev # 强制仅快进合并
  git merge --no-ff feature/login # 强制创建合并提交（即使可以快进）
  git log --graph --oneline --decorate # 查看合并后的线性历史
  

• 特点：
  • 线性历史
  • 无合并提交
  • 适用于临时特性分支

② Recursive（递归合并）

• 触发条件：存在分叉提交且需三方合并。
• 命令示例：

  git merge -s recursive -X patience dev # 使用特定差异算法
  

• 特点：
  • 自动处理多个共同祖先
  • 产生合并提交
  • 默认策略（占 Git 合并的 70%+）

③ Ours/Theirs（选择性合并）

• 触发条件：需要强制保留特定分支内容。
• 命令示例：

  # 正确流程示例（架构迁移场景）：
  git checkout new-arch
  git merge -s ours old-arch # 保留新架构
  
  git checkout old-arch
  git merge new-arch # 同步代码但保留旧架构
  

• 特点：
  • 人工指定冲突解决方案
  • 常用于保留分支架构
  • 高风险操作（可能覆盖代码）

④ Octopus（章鱼合并）

• 触发条件：同时合并多个分支。
• 命令示例：

  git merge dev feat hotfix # 一次性合并三个分支
  

• 特点：
  • 仅限无冲突合并
  • 常用于 CI/CD 流水线
  • 历史记录最简洁

⑤ Subtree（子树合并）

• 触发条件：合并外部仓库到子目录。
• 命令示例：

  git merge -s subtree --allow-unrelated-histories external-repo
  

• 特点：
  • 保留外部仓库独立历史
  • 自动处理路径冲突
  • 适合组件化开发

⑥ Resolve（解决合并）

• 触发条件：简单分叉合并（Git 早期版本）。
• 命令示例：

  git merge -s resolve legacy-branch
  

• 特点：
  • 仅处理单共同祖先
  • 比 recursive 更快
  • 逐渐被淘汰

3. 策略对比矩阵

4. 实战场景推荐

1. 功能开发：Recursive（默认） + --no-ff 保留合并痕迹
2. 紧急修复：Fast Forward 快速上线
3. 架构迁移：Ours 策略保留新架构
4. 多特性发布：Octopus 一次合并多个已验证分支
5. 组件更新：Subtree 管理子仓库
6. 遗留系统：Resolve 处理简单合并

5. 高级调试技巧

# 查看可用的合并策略
git merge -shelp
# 显示合并细节（调试用）
git merge --verbose --stat -m "合并日志"
# 分析合并基准
git merge-base --all master dev
# 可视化合并过程
git mergetool -t meld

分支治理规范：

1. 黄金法则：main 分支必须使用 --no-ff 合并。
2. 权限控制：保护分支禁止使用 theirs 策略。
3. 合并检查清单：
   • ✅ 代码评审完成
   • ✅ CI 流水线通过
   • ✅ 文档同步更新
   • ✅ 兼容性测试报告

合并策略决策逻辑：

在决策时，首先判断目标分支是否落后于当前分支。若落后且无冲突，优先 Fast Forward；若有多个共同祖先，使用 Recursive with patience；需要强制覆盖则用 Ours/Theirs；合并多个分支选 Octopus；合并子目录选 Subtree；处理简单分叉可用 Resolve。

实际开发中需要根据项目需求选择最合适的合并方式。建议在团队中制定《合并策略规范》，例如长期分支强制使用 --no-ff，第三方库必须用 subtree 等，以保持代码库的健康度。