Git带指针移动的squash merge实现单向瀑布式合并需求

场景回顾 #

当前仓库分支提交结构如下：

dev: [base]....A..B..C..D..E..F..G..H..I..J..K..L..M..N..O..P..Q..R..S..T..U..V..W..X..Y..Z....
       |                                                    \                       \     \
tst: [base]..................................................P'......................X'....Z'....
       |                                                                                   \
prd: [base].................................................................................Z''....

我们的需求是：保留dev/tst/prd各分支完整历史，同时让更高环境分支（tst、prd）拥有简洁的提交记录；解决后续Squash Merge时的冲突问题，实现类似永久单向瀑布式的同步，且不能用Rebase（需保留低环境分支历史）。

核心解决方案：提交等价映射+受控merge -s ours标记 #

Git原生没有提交等价映射的功能，但可以通过手动维护提交范围映射+空提交标记同步状态的方式，实现无冲突的单向同步，同时不破坏提交图。

1. 建立提交等价映射

每次完成Squash Merge后，记录低环境分支的提交范围与高环境分支Squash提交的对应关系：

• 用Git Notes给Squash提交添加标记（团队内可见）：

  # 给tst分支的P'提交添加备注，说明它等价于dev的A到P提交
  git notes add -m "等价于dev分支A~P提交" <P'的提交哈希>
  

• 或者维护一个本地/仓库内的配置文件（比如.git/equivalent-commits），统一管理映射：

  # 格式：高环境提交哈希 = 低环境提交范围
  <P'哈希> = A..P
  <X'哈希> = Q..X
  <Z'哈希> = Y..Z
  <Z''哈希> = Z'
  

2. 无冲突同步流程（以dev→tst为例）

当需要把dev的Q-X提交同步到tst时，按以下步骤操作：

1. 标记已同步的历史：先执行一次空的merge -s ours，告诉Git dev分支的A-P提交已经被tst的P'覆盖，无需再处理这部分差异：

   git checkout tst
   # 找到dev分支中P提交的位置（比如dev~15，具体根据提交数量调整）
   git merge -s ours --no-commit dev~15
   # 提交一个空的合并记录，仅用于标记同步状态
   git commit --allow-empty -m "标记dev分支A~P已同步至tst的P'"
   

2. 执行Squash Merge：此时Git会自动跳过已标记的A-P提交，只处理Q-X的新差异，大幅减少冲突：

   git merge --squash dev
   git commit -m "合并dev分支Q~X提交（Squash）"
   

3. 更新等价映射：把新生成的X'提交与dev的Q-X范围添加到映射记录中。

3. prd分支同步同理

当tst的Z'要同步到prd时，重复上述流程：先标记tst的P'~X'已同步，再Squash Merge Z'到prd生成Z''，最后更新映射。

关键优势 #

• 既保留了dev分支的完整提交历史，又让tst/prd分支的历史保持简洁；
• 避免了直接Squash Merge后续提交时的重复冲突，因为Git已通过空提交标记了已同步的历史；
• merge -s ours的空提交不会影响代码内容，仅在提交图中添加同步标记，不会破坏分支结构。

内容的提问来源于stack exchange，提问作者Philip Kahn