清理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] —— 注意这个“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 fetch -p，让远程状态保持同步。
• 在大团队里，定期清理无效分支能有效减少混乱和误操作。
• 如果不确定某个分支是否该删，先用 git branch -vv 检查一下，心里有底了再动手。