GitHub 分支已删除，git branch -a 仍显示 origin 分支

在 GitHub 合并 Pull Request 并删除分支后，网页上的分支列表已经找不到它，本地 git branch -a 却仍显示 remotes/origin/feature/old-task。这通常是本地保存的远程跟踪引用尚未清理，不能仅凭这行输出判断 GitHub 删除失败。

git branch -a 汇总本地已有的分支引用，并不会每次都向服务器查询。正常抓取也不一定会清理已经从服务器消失的引用，需要显式使用 prune，或已有配置启用了自动清理。

下面以远程名 origin、待检查分支 feature/old-task 为例，两者都要替换成实际值。下面处理普通克隆仓库中的过期远程跟踪引用；镜像仓库、特殊 refspec 映射和本地开发分支的删除需要分别判断。

先分清列表里是哪一种分支

同一个短名称可能对应不同对象：

看到的名称	存放位置与含义
feature/old-task	本地开发分支，位于 refs/heads/
origin/feature/old-task	本地记录的 origin 分支状态，通常位于 refs/remotes/origin/
GitHub 网页上的 feature/old-task	服务器仓库中的分支

分开列出本地分支和远程跟踪分支：

git branch --list 'feature/old-task'
git branch -r --list 'origin/feature/old-task'

如果只有第二条有输出，清理目标就是远程跟踪引用。如果第一条也有输出，说明还存在一个独立的本地开发分支；清理远程跟踪引用后，它仍然保留是正常行为。

不要用删除本地开发分支的命令来“刷新列表”。本地分支可能还保存着未推送的提交，远程删除并不能证明这些提交已经安全合并。

确认 origin 指向同一仓库，再查询服务器

先检查实际远程地址：

git remote get-url origin

确认它指向刚才查看的 GitHub 仓库，而不是 fork、另一个组织的仓库或同名项目。地址可能包含内部信息，分享诊断输出前要清理凭据和私有地址。

随后直接查询目标分支的完整引用名：

git ls-remote --exit-code origin 'refs/heads/feature/old-task'
printf 'exit=%s\n' "$?"

成功找到时，会输出提交 ID 和 refs/heads/feature/old-task，退出码为 0。没有匹配引用时，--exit-code 会使退出码为 2。这里需要同时查看错误输出：网络、认证或权限错误不能当成“分支已经不存在”的证据。

查询只反映当前地址和身份能看到的远程状态。如果服务器仍返回这个分支，就先核对网页上的仓库、分支拼写，以及是否有人重新创建了同名分支；此时 prune 不应把它当成过期引用删除。

清理前核对 refspec 和标签设置

prune 的作用范围由引用映射决定，并不是在所有仓库里都只清理 origin/*。先查看当前远程的抓取映射和标签清理设置：

git config --get-all remote.origin.fetch
git config --get fetch.pruneTags
git config --get remote.origin.pruneTags

普通克隆仓库的分支映射通常是：

+refs/heads/*:refs/remotes/origin/*

它把远程分支映射到本地 refs/remotes/origin/。在这种映射下，且没有启用标签清理时，下面的操作清理过期远程跟踪引用，不会删除 refs/heads/ 下的本地开发分支，也不会向 GitHub 发出删除分支请求。

配置查询没有值时可能无输出并返回非零状态，不必因此添加配置。如果存在多条映射，要全部看完；如果目标包含 refs/tags/*、refs/heads/*，或者设置了标签清理，就不能套用“只删远程跟踪分支”的判断。镜像仓库和多个远程共用引用目标的仓库也应先单独审查范围。

本次只处理分支列表，不需要额外加上 --prune-tags。它可能删除远程没有的本地标签，包括你自己创建但没有推送到该远程的标签。

先预览，再清理过期引用

在确认远程地址、映射和范围后，先预览：

git remote prune --dry-run origin

这会查询远程并报告将被清理的引用，但不会执行清理。它可能列出不止一条过期引用，需逐条确认，而不是只检查目标名称有没有出现。

如果仍需要保留某条过期引用所指向的提交，可以在清理前为它创建一个明确的本地保留分支。以下保留分支名也只是示例，需选用尚不存在的名称：

git branch --no-track keep-old-task origin/feature/old-task

这会保留提交入口，不会切换工作区，也不备份未提交的文件。普通清理不会改动工作区文件，但保留分支应在旧引用仍存在时建立。不要依赖之后一定能从 reflog 或对象库找回所有内容。

确认预览结果后，可以使用：

git fetch --prune origin

这次操作会正常抓取 origin 的更新，并清理已经过期的映射引用。它不会像 pull 那样把抓取结果合并进当前工作分支。

如果只想清理、不想抓取新的引用，可以改用下面这一条；两种方式按需要选一种即可：

git remote prune origin

不需要为这个问题运行 git gc、删除 .git，也不需要把列表中的名称批量交给强制删除命令。手动删除某条仍存在于远程的跟踪引用，只会使它在后续抓取时重新出现。

清理后的核对与保留分支

再次分别查询两个本地命名空间：

git branch -r --list 'origin/feature/old-task'
git branch --list 'feature/old-task'

远程确认已无该分支、抓取或清理成功后，第一条应不再显示过期引用。第二条若仍有输出，说明本地开发分支还在，不能据此认定 prune 失败。

如果远程跟踪引用仍显示，回到输出中的 remote 名、fetch 映射以及这次命令的错误信息检查。多远程仓库中，清理 origin 不会替你同步另一个远程的独立命名空间；服务器重新创建同名分支时，新的引用也会被正常抓取。

清理后还需要查看旧提交时，可以使用之前建立的保留分支。不要为了恢复本地列表，擅自把已删除的分支重新推送到共享仓库。是否恢复服务器分支属于另一项协作操作。

确认范围后再启用自动清理

如果这个仓库一直使用上述普通分支映射，可以只对当前仓库的 origin 启用自动清理：

git config --local remote.origin.prune true

这样以后从 origin 抓取时会应用 prune，后续 pull 中的抓取步骤也会受到影响。设置前应记录该键原来的值；如果原本没有本地设置，撤销本次新增项可用：

git config --local --unset remote.origin.prune

如果原本已有值，则恢复那个值。删除本地项后，更高范围的配置仍可能生效，例如全局的 fetch.prune，所以“撤销本次设置”不等于“强制关闭所有自动清理”。未来修改 refspec 或开启标签清理时，也要重新审查 prune 的实际范围。