Remove tracking branches no longer on remote

技术背景

在使用Git进行版本控制时，随着项目的推进，会创建很多分支。当远程分支被删除后，本地的跟踪分支就会变成孤立分支，继续保留这些分支会使本地仓库变得杂乱。因此，需要清理这些不再存在于远程的跟踪分支。

在跟踪分支的场景中，实际上存在三个分支：远程仓库的分支、本地仓库的远程跟踪分支（remotes/origin/xxx）和本地分支。当远程分支被删除后，本地的远程跟踪分支可以通过git fetch --prune自动清理，但本地分支不会自动删除。

实现步骤

方法一：使用git for-each-ref和脚本

git fetch -p && for branch in $(git for-each-ref --format '%(refname) %(upstream:track)' refs/heads | awk '$2 == "[gone]" {sub("refs/heads/", "", $1); print $1}'); do git branch -D $branch; done

步骤解释：

1. git fetch -p：从远程仓库获取最新信息并清理不再存在于远程的远程跟踪分支。
2. git for-each-ref --format '%(refname) %(upstream:track)' refs/heads：列出所有本地分支及其上游跟踪状态。
3. awk '$2 == "[gone]" {sub("refs/heads/", "", $1); print $1}'：筛选出上游状态为[gone]的本地分支名称。
4. git branch -D $branch：强制删除这些分支。

方法二：使用git branch -vv和grep

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

步骤解释：

1. git fetch -p：清理远程跟踪分支。
2. git branch -vv：显示本地分支的详细信息，包括远程状态。
3. grep ': gone]'：筛选出远程状态为gone的分支信息。
4. awk '{print $1}'：提取分支名称。
5. xargs git branch -D：强制删除这些分支。

方法三：添加别名到gitconfig

git config --global alias.branch-prune '!git fetch -p && for b in $(git for-each-ref --format='\'%(if:equals=[gone])%(upstream:track)%(then)%(refname:short)%(end)\'' refs/heads); do git branch -d $b; done'

步骤解释：

1. 通过git config --global设置全局别名branch-prune。
2. 别名对应的命令中，git fetch -p清理远程跟踪分支，然后筛选出上游状态为[gone]的本地分支并删除。之后可以使用git branch-prune来清理不再存在于远程的本地跟踪分支。

Windows PowerShell解决方案

git checkout master; git remote update origin --prune; git branch -vv | Select-String -Pattern ": gone]" | % { $_.toString().Trim().Split(" ")[0]} | % {git branch -d $_}

步骤解释：

1. git checkout master：切换到主分支。
2. git remote update origin --prune：更新远程分支并清理不再存在于远程的分支。
3. git branch -vv：显示本地分支详细信息。
4. Select-String -Pattern ": gone]"：筛选出远程状态为gone的分支信息。
5. % { $_.toString().Trim().Split(" ")[0]}：提取分支名称。
6. % {git branch -d $_}：删除这些分支。

核心代码

删除所有不在远程的本地分支

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

删除所有已合并到主分支且不在远程的本地分支

git fetch -p && git branch --merged | grep -v '*' | grep -v 'master' | xargs git branch -d

确保保留特定分支

git branch --merged | grep -v '*' | grep -v 'master' | grep -v 'develop' | grep -v 'staging' | xargs -n 1 git branch -d

添加别名到.zshrc或.bashrc

alias gbpurge='git branch --merged | grep -v "*" | grep -v "master" | grep -v "develop" | grep -v "staging" | xargs -n 1 git branch -d'

最佳实践

• 定期清理：定期执行清理操作，保持本地仓库的整洁。
• 使用别名：将常用的清理命令添加为别名，方便快速执行。
• 谨慎删除：在删除分支前，确保这些分支确实不再需要，特别是在使用强制删除选项-D时。

常见问题

部分分支无法删除

使用-d选项删除分支时，如果分支未完全合并，会出现错误提示。可以使用-D选项强制删除，但要谨慎操作。例如：

error: The branch 'xxx' is not fully merged.

语言设置问题

如果系统语言不是英语，在使用grep筛选gone时，需要将gone替换为相应语言的单词。

误删风险

在使用git branch --merged列出的分支进行删除时，要注意列表中可能包含master或其他重要分支，避免误删。可以通过grep -v排除这些分支。