GitHub合并PR后dev分支提交落后数递增问题及修复咨询

问题原因 #

GitHub默认合并PR时会生成一个新的合并提交，将dev分支的修改合并到main。此时main分支会多出这个合并提交，但dev分支的提交历史仍停留在合并前的状态，因此GitHub会显示dev落后于main（落后的提交数就是每次新增的合并提交），且每次合并都会累加这个差值。

修复当前dev分支的方法 #

方法1：合并main更新到dev（保留完整历史） #

在本地仓库执行以下命令：

• 切换到main分支并拉取最新代码：

  git checkout main
  git pull origin main
  

• 切回dev分支并合并main的更新：

  git checkout dev
  git merge main
  

• 推送更新到远程dev分支：

  git push origin dev
  

执行后dev分支会包含main的合并提交，后续就不会再显示落后。

方法2：变基dev到main（整理线性提交历史） #

如果需要更简洁的线性提交记录，可以使用变基操作：

• 切换到dev分支：

  git checkout dev
  

• 将dev变基到最新的远程main分支：

  git rebase origin/main
  

• 若出现冲突，解决冲突后继续变基：

  git rebase --continue
  

• 强制推送到远程dev分支（变基改写了历史，需强制推送）：

  git push origin dev --force-with-lease
  

注意：如果dev是多人协作分支，禁止使用变基，会打乱其他协作者的提交历史。

避免后续重复出现的方法 #

选项1：合并PR时选择「变基并合并」 #

在GitHub的PR合并界面，选择「Rebase and merge」选项。该方式会将dev的提交直接迁移到main的最新提交之后，合并后main的历史是线性的，dev与main的提交记录一致，不会出现落后问题。

选项2：定期同步dev与main #

开发过程中，定期将main的更新合并到dev分支，保持两个分支的同步，避免合并PR时出现大量差异。

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