Skip to content

变基与合并混淆

快速摘要

你变基了但本意是合并(或相反),产生了线性历史而非合并提交 —— 队友可能看到被重写的提交。

为什么发生

  • 出于习惯或拼写错误运行了 git rebase 而非 git merge,将本地提交重写到目标分支之上

  • 团队约定要求合并提交但你用了变基,或约定要求变基但你合并了

  • 你变基了已推送和共享的提交,导致队友的历史分歧

最小示例

✗ 错误代码
git rebase main  # intended git merge main — history rewritten
git push --force  # teammates see rewritten commits
✓ 修复代码
git rebase --abort  # if still in progress
git reset --hard ORIG_HEAD  # undo completed rebase
git merge main  # create merge commit as originally intended

ORIG_HEAD 指向变基开始前的状态,允许你撤销变基并执行合并,保留原始提交哈希。

如何诊断

  • 运行 git log --oneline --graph 查看历史是线性的(变基)还是含合并提交(合并)

  • 如果需要撤销变基并切换到合并,检查 git reflog 找到变基前的状态

  • 比较本地和远程 git log origin/branch..HEAD 查看提交是否被重写且需要强制推送

如何修复

  • 如果仍在进行中,用 git rebase --abort 撤销;或用 git reset --hard ORIG_HEAD 恢复变基前状态

  • 如果合并了但应该变基,用 git reset --hard HEAD~1 回退到合并前,然后 git rebase origin/branch

  • 如果变基后已推送,与队友协调并使用 --force-with-lease 同步历史

如何预防

  • 就团队约定(变基 vs 合并)达成一致并记录在 CONTRIBUTING.md 中,避免不一致的历史

  • 永远不要变基已推送到共享分支的提交 —— 只变基本地未推送的提交

相关资源

相关术语

相关课程

← 返回语言