变基与合并混淆
快速摘要
你变基了但本意是合并(或相反),产生了线性历史而非合并提交 —— 队友可能看到被重写的提交。
为什么发生
出于习惯或拼写错误运行了 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 intendedORIG_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 中,避免不一致的历史
永远不要变基已推送到共享分支的提交 —— 只变基本地未推送的提交
相关资源
相关课程
- git rebase
学习何时变基与合并。