GitHub合并staging到main后提交差异堆叠问题及解决方法

问题根源 #

你遇到的核心问题是staging分支的历史没有与main分支同步，导致GitHub的分支对比算法会把staging上所有未在main分支历史链中的提交（哪怕内容已经通过合并同步）都判定为差异。不管用squash and merge还是create a merge commit，合并后staging分支的起点仍停留在合并前的状态，后续对比自然会堆叠旧提交。

解决方案 #

前提准备 #

确保本地工作区干净，没有未提交的变更：

git status

若显示nothing to commit, working tree clean，再执行后续操作。

方法1：变基（Rebase）对齐历史（保留staging提交记录） #

适合需要保留staging分支迭代提交历史的场景：

• 拉取main分支最新代码：

  git checkout main && git pull
  

• 切换到staging分支并变基到main：

  git checkout staging
  git rebase main
  

  • 若出现冲突，手动解决冲突后执行：

    git add .
    git rebase --continue
    

    重复此步骤直到变基完成。
• 强制推送更新远程staging分支（变基修改了历史，必须强制推送）：

  git push -f origin staging
  

方法2：硬重置（Hard Reset）到main（清空staging历史） #

适合staging作为临时集成分支，不需要保留历史的场景：

• 拉取main分支最新代码：

  git checkout main && git pull
  

• 切换到staging分支并重置到main的最新状态：

  git checkout staging
  git reset --hard main
  

• 强制推送更新远程staging分支：

  git push -f origin staging
  

关键注意事项 #

• 强制推送会覆盖远程分支的历史，操作前必须确认：
  1. 没有其他团队成员在staging分支上有未推送的变更
  2. 提前告知团队成员后续需要重新拉取staging分支
• 后续每次将staging合并到main后，都要执行上述操作，保持staging与main的历史对齐，避免再次出现差异堆叠问题

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