如何判断分支是否已经合并

判断分支是否已合并:git branch --merged main 列出顶端提交可从 main 到达的分支(不带 main 时默认 HEAD);精确判断用 git merge-base --is-ancestor <分支> main && echo merged;看远程分支用 git branch -r --merged。

最佳实践
Git 分支协作与合并示意

两种检查方式:列出式的 git branch --merged main——出现在列表里就是已合并;脚本式的 git merge-base --is-ancestor feature-x main && echo "已合并"(退出码 0 即已合并),适合写进自动化。

交互检查

git checkout main
git branch --merged          # 已合并进 main 的本地分支
git branch --no-merged       # 还没合并的(这些要留意)
git branch -r --merged       # 远程分支版本

精确判断(脚本友好)

if git merge-base --is-ancestor feature-x main; then
  echo "feature-x 已合并进 main"
else
  status=$?
  if [ "$status" -eq 1 ]; then echo "未合并"; else echo "检查失败,退出码: $status" >&2; fi
fi

原理:分支的顶端提交是 main 的祖先 = 它的所有提交都在 main 里。

注意 squash merge 的坑

GitHub 的 Squash and merge 把分支提交压成一个新提交——原分支提交并未进入 main,--merged 和 --is-ancestor 都会显示"未合并"!这时判断要看内容是否等价:

git cherry main feature-x     # 带 - 前缀的表示改动已在 main 中

git cherry 比较单个提交补丁等价性,不能可靠识别多个提交被合成一个 squash 的总体等价;应查看平台合并记录并核对净差异。确认内容与用途后,squash 合并的分支删除时可用 git branch -D(未通过上游或 HEAD 的可达性检查时,-d 会拒绝)。

常见问题(FAQ)

Q:--merged 显示已合并就能安全删除吗?

该检查证明可达性,不代替用途确认;-d 检查配置的上游,无上游才检查 HEAD,并不一定与 --merged main 相同。还需考虑:分支还被其他未合并分支依赖,或指向的提交是某 tag 的祖先之外的特殊用途。

Q:能查"什么时候合并的"吗?

git log --merges --oneline main | grep 分支名 找合并提交;git log --grep="分支名" --oneline main 也常有线索。

Q:远程分支怎么批量清理未合并的?

反过来用:git branch -r --no-merged main 列出未合并的远程分支,逐个确认是进行中还是该删。

参考资料

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台