彻底清理 Git 分支：从查看到批量删除无效分支的全流程指南

在日常开发中，我们经常会创建临时分支用于开发新功能或修复 Bug。随着时间推移，这些分支被合并、删除，但本地仓库中仍可能保留大量过期分支。

这篇文章带你一步步彻底清理本地无用分支，并同步远程状态。

---

一、查看本地分支

首先查看当前仓库中有哪些本地分支：

git branch

输出结果类似：

* main
  feature/login
  fix/typo

* 表示当前所在分支。

二、查看本地分支与远程分支的状态

要想知道哪些本地分支仍对应远程、哪些已经失效，可以使用：

git branch -vv

示例输出：

* main               8b2c34a [origin/main] Merge pull request #42 from dev
  feature/login      12d5a90 [origin/feature/login: gone] Add login form
  fix/typo           77ff0ab [origin/fix/typo] fix typo in readme

🔍 说明：

• [origin/main]：表示该分支仍然对应远程分支。
• [origin/feature/login: gone]：表示远程分支已经被删除，本地分支仍保留。

三、删除本地分支

如果确认某个本地分支不再需要，可以手动删除：

git branch -d branch-name

如果分支未被合并，Git 会阻止删除。若确定要强制删除，可使用：

git branch -D branch-name

四、删除远程分支

远程分支删除需要使用以下命令：

git push origin --delete branch-name
# 等价
git push origin :branch-name

此命令会从远程仓库（如 GitHub、GitLab）中移除指定分支。

五、清理已被远程删除的追踪引用

有时远程分支被删除后，本地仍会显示对应的追踪引用（如 origin/feature/xxx），可以通过以下命令清理：

git fetch -p

选项 -p 等价于 --prune，表示"修剪"掉所有在远程已不存在的引用。

六、批量删除所有已被远程删除的本地分支

想一键清理所有 [gone] 状态的分支？

可以使用以下命令组合：

git branch -vv | grep ': gone]' | awk '{print $1}' | xargs git branch -D

🧩 命令拆解说明：

命令片段	作用
git branch -vv	显示分支及其远程状态
grep ': gone]'	筛选出远程已删除的分支
awk '{print $1}'	取出分支名称（第1列）
xargs git branch -D	将这些分支传给 git branch -D 批量删除

执行后，所有远程已删除但本地仍存在的分支将被清理干净。

七、总结

操作	命令
查看本地分支	git branch
查看分支与远程状态	git branch -vv
删除本地分支	git branch -d <name> / git branch -D <name>
删除远程分支	git push origin --delete <name>
清理远程已删除引用	git fetch -p
批量清理"已失效"本地分支	`git branch -vv

✨小结建议

• 建议定期执行 git fetch -p 保持远程状态同步。
• 大型团队中，定期清理无效分支可显著减少混乱与误操作。
• 若不确定分支是否重要，可先用 git branch -vv 检查再删除。