如何自动清理本地已在GitHub删除的Git分支？

我完全理解你的顾虑——基于分支名称的批量删除确实有风险，尤其是在存在同名分支的场景下，很容易误删无关分支。我们可以利用Git本身的分支追踪状态（而非名称）来精准识别那些对应的远程分支已经被删除的本地分支，再批量清理，同时可以把这个逻辑集成到Git Hook实现自动化。

核心思路：通过Git的追踪标记识别已失效的本地分支 #

当你执行git remote prune origin后，Git会更新本地对远程分支的引用，那些对应的远程分支已经被删除的本地分支，在执行git branch -vv时会显示[origin/xxx: gone]的标记。我们可以基于这个标记来筛选需要删除的分支，这是基于分支的追踪关系（而非名称），完全避免同名分支误删的问题。

第一步：编写批量清理脚本 #

创建一个可执行的脚本（比如clean-gone-branches.sh），内容如下：

#!/bin/bash

# 先更新本地远程分支引用，确保标记准确
git remote prune origin

# 筛选出所有追踪分支已失效（gone）的本地分支，排除当前分支和master分支
gone_branches=$(git branch -vv | grep ': gone]' | awk '{print $1}' | grep -v '^*' | grep -v 'master')

# 循环删除这些分支（使用-d确保只删除已合并的分支，更安全；如果要强制删未合并的，换成-D）
for branch in $gone_branches; do
    echo "Deleting local branch: $branch"
    git branch -d "$branch"
done

脚本说明： #

• git remote prune origin：先同步远程分支状态，确保本地能准确识别哪些远程分支已被删除
• git branch -vv | grep ': gone]'：筛选出所有追踪的远程分支已不存在的本地分支
• awk '{print $1}'：提取分支名称
• grep -v '^*'：排除当前正在检出的分支（避免删除当前分支）
• grep -v 'master'：保留master分支，你可以根据需要添加其他要保留的分支（比如develop）
• git branch -d：只删除已合并到当前检出分支的本地分支，如果你需要强制删除未合并的分支，把-d换成-D，但不推荐强制删除未合并分支

第二步：集成到Git Hook实现自动化 #

如果你想在合并到master后自动执行清理，可以修改post-merge Hook：

1. 进入你的Git仓库的.git/hooks目录
2. 创建或编辑post-merge文件（注意没有后缀），内容如下：

#!/bin/bash

# 只在合并到master分支时执行清理
TARGET_BRANCH=$(git rev-parse --abbrev-ref HEAD)
if [ "$TARGET_BRANCH" = "master" ]; then
    # 调用刚才的脚本，这里假设脚本放在仓库根目录，或者写绝对路径
    ./clean-gone-branches.sh
fi

3. 给post-merge和clean-gone-branches.sh添加可执行权限：

chmod +x .git/hooks/post-merge
chmod +x clean-gone-branches.sh

这样，每次你合并到master分支后，Git会自动执行清理脚本，删除那些对应的远程分支已经被删除的本地分支。

额外验证：确保不会误删同名分支 #

假设你之前有一个Branch-A被删除了远程分支，后来又新建了一个同名的Branch-A，并且设置了新的远程分支（或者没有设置追踪）：

• 如果新的Branch-A没有设置追踪远程分支，git branch -vv不会显示gone标记，脚本不会删除它
• 如果新的Branch-A追踪的是存在的远程分支，也不会被标记为gone，同样不会被删除

完全基于分支的追踪状态判断，彻底避免了同名分支误删的问题。

内容的提问来源于stack exchange，提问作者user2012677