如何创建合适的Git Squash合并提交并消除分支历史分歧？

一、解决分支b与a的历史分歧问题 #

我之前处理过几乎一模一样的场景，核心是要在保留b分支完整历史的前提下，用单个提交消除GitHub显示的"b领先a"状态，同时不破坏现有历史。具体步骤如下：

1. 先确保本地分支是最新状态：

   # 切换到b分支并拉取最新远程代码
   git checkout b
   git pull origin b
   
   # 更新本地a分支到远程最新状态
   git fetch origin a
   git checkout a
   git pull origin a
   git checkout b
   

2. 验证b和a的代码完全一致：

   git diff a b
   

   这个命令应该没有任何输出，确认代码无差异。

3. 执行特殊合并提交解决历史分歧：

   git merge a -s ours --no-ff
   

   • -s ours：这个合并策略会完全忽略a分支的变更，直接使用当前b分支的内容作为合并结果（刚好和a一致，所以不会有任何代码改动）。
   • --no-ff：强制生成一个新的合并提交，而不是快进合并，这样就能把a的历史线合并到b上。

4. 推送到远程仓库：

   git push origin b
   

   这一步不需要强制推送，因为我们是在b分支上新增了一个合法的合并提交，远程仓库会接受这个推送。之后GitHub就会显示b和a的历史已对齐，不再有"领先"的提示，同时b分支之前的cherry-pick历史也完整保留了。

二、创建合适的Git压缩合并提交 #

压缩合并主要用于把多个零散提交打包成一个整洁的提交，常见于PR合并或整理自己的开发分支，分两种场景：

场景1：把其他分支的变更压缩后合并到当前分支

比如要把feature分支的所有提交压缩后合并到main分支：

# 切换到目标分支并拉取最新代码
git checkout main
git pull origin main

# 执行压缩合并（不会自动创建提交）
git merge --squash feature

# 手动创建压缩后的提交，写清楚变更摘要
git commit -m "Squashed merge: 实现用户头像上传功能（包含格式校验、存储优化）"

这样main分支上只会有一个提交，包含feature分支的所有变更，而feature分支的原始历史仍然保留。

场景2：压缩自己分支上的多个本地提交

如果是在自己的私有分支上，想把最近n个提交压缩成一个，可以用交互式变基：

# 选择要压缩的最近3个提交（把3改成你需要的数量）
git rebase -i HEAD~3

在弹出的编辑器里，把除了第一个提交之外的pick改成squash（会保留这些提交的信息）或fixup（直接丢弃这些提交的信息），保存后Git会自动合并这些提交，然后你可以编辑最终的提交信息。

⚠️ 注意：不要在公共分支（比如main、develop）上使用变基或压缩合并，因为这会修改历史，导致其他协作者的本地分支和远程分支冲突。只有在自己的私有分支，或者团队明确同意的情况下才这么做。

内容的提问来源于stack exchange，提问作者Jon Rowe