Skip to content

git pull 静默创建了合并提交

快速摘要

你运行了 git pull 并得到了不期望的合并提交 —— 默认拉取策略执行了合并而非快进或变基。

为什么发生

  • 你的本地分支有远程没有的提交,因此 git pull --merge 创建了合并提交而非快进

  • 你未配置 pull.rebase true,git 默认使用合并,对分歧历史创建合并提交

  • 队友推送了与你本地历史分歧的提交,使快进不可能而触发了合并

最小示例

✗ 错误代码
git pull  # creates unexpected merge commit: 'Merge branch 'feature' of origin'
✓ 修复代码
git reset --hard HEAD~1  # undo merge commit
git config pull.rebase true
git pull  # now rebases instead of merging

配置 pull.rebase true 使 git pull 将本地提交重放到远程修改之上,产生无合并提交的线性历史。

如何诊断

  • 运行 git log --oneline --graph -5 查看合并提交并了解导致它的分歧

  • 检查 git config pull.rebase —— 如果未设置或为 false,git pull 默认使用合并

  • 运行 git log --oneline HEAD..origin/branch 和 git log --oneline origin/branch..HEAD 查看分歧的两侧

如何修复

  • 用 git reset --hard HEAD~1 撤销合并提交,然后用 git pull --rebase 重新拉取获得线性历史

  • 配置 git 始终在拉取时变基:git config --global pull.rebase true,避免未来的合并提交

  • 如果合并提交已推送且可接受,保留它 —— 但切换到变基以保持未来拉取的线性历史

如何预防

  • 设置 git config --global pull.rebase true 使 git pull 默认使用变基,获得更干净的线性历史

  • 使用 git pull --ff-only 拒绝非快进拉取,强制你显式决定如何整合分歧修改

相关资源

相关术语

相关课程

← 返回语言