在日常开发中，我们常常会创建临时分支用于开发新功能或修复 Bug。随着时间推移，这些分支被合并、删除，但本地仓库中仍可能保留大量过期分支。这篇文章带你一步步彻底清理本地无用分支，并同步远程状态。

一、查看本地分支

第一查看当前仓库中有哪些本地分支：

git branch

输出结果类似： #技术分享

* main
  feature/login
  fix/typo

* 表明当前所在分支。

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

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

git branch -vv

示例输出：

* main               8b2c34a [origin/main] Merge pull request
  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 / git branch -D | | 删除远程分支 | git push origin --delete | | 清理远程已删除引用 | git fetch -p | | 批量清理“已失效”本地分支 | git branch -vv | grep ': gone]' | awk '{print $1}' | xargs git branch -D |

✨小结提议

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