如何通过Git指南有效清理和维护不再需要的分支？

本文共计1001个文字，预计阅读时间需要5分钟。

删除分支不是删除代码，而是删除指针；不清理远程引用，本地使用`git branch -r`，这里还会显示已删除的分支。

为什么 git branch -d 会报错 “not fully merged”

Git 默认只允许安全删除「已完全合并到当前所在分支」的本地分支。git branch -d 会检查该分支的所有提交是否都存在于当前 HEAD（比如 main）的 commit DAG 中。如果存在未合并的提交，它就拒绝操作，防止误丢改动。

• 常见错误现象：error: The branch 'feat/payment' is not fully merged.
• 先确认是否真要丢弃：运行 git log --oneline feat/payment ^main 看哪些提交没进 main
• 若确定无用，改用 git branch -D feat/payment 强删；但注意：rebase 中断状态、stash 关联、未推送提交都会随分支指针一起消失
• 别在 CI/CD 脚本里无条件用 -D —— 如果某次构建临时分支名撞上正在开发的 feature，强删会直接丢掉同事刚 push 的内容

删完远程分支，git branch -r 还能看到？

因为 git push origin --delete branch-name 只通知远端删分支，本地仍保留着过时的远程跟踪引用（remote-tracking reference），即 origin/branch-name。