git fetch --prune 是清理远程分支缓存的唯一可靠方式，因为它在拉取最新远程状态的同时自动删除本地过期的远程追踪引用，而其他操作如 pull 或等待均不会触发此清理。
git fetch --prune 为什么是清理远程分支缓存的唯一可靠方式
删完远程分支后，git branch -r 还显示它，不是 Git 出 bug，而是本地还存着过期的远程追踪引用。这些引用存在 .git/refs/remotes/origin/ 下，Git 不会自动同步远端变更——它只在你主动 fetch 时才更新快照。
所以不能靠「等一会儿」或「再 pull 一次」来刷新，必须显式触发清理：
-
git fetch --prune（推荐）：拉取最新远程状态的同时，把本地多出来的origin/xxx全部删掉 -
git fetch -p：等价缩写，效果相同 -
git remote prune origin：语义接近，但部分旧版 Git（
执行后立刻再跑 git branch -r，就能看到干净列表了。IDE（如 VS Code）Git 面板可能缓存更久，需手动点「Fetch」或重启面板。
删远程分支后，本地同名分支还报 fatal: couldn't find remote ref
这个错误不是因为远程分支没删干净，而是本地分支还挂着已失效的上游配置。比如你有个本地分支 feature/login，曾用 git branch --set-upstream-to=origin/feature/login 关联过远程分支；现在远程分支被删了，但这个配置还在。
下次在该分支上运行 git pull，Git 仍会按配置去合并 origin/feature/login，结果就是报错。
解决方法分三种场景：
- 如果本地分支也不需要了：
git branch -d feature/login - 如果想保留本地分支但去掉无效追踪：
git branch --unset-upstream feature/login - 如果要换到新主干继续开发：
git branch --set-upstream-to=origin/main feature/login
注意：git branch -d 会拒绝删除未合并的分支，避免误丢提交；若确定要强删，改用 git branch -D。
批量清理“已合并但残留”的远程分支引用
日常维护中，最常见的是大量 origin/feature/* 分支已合并进 main，但本地缓存还留着。手动一个个删不现实，得靠脚本筛选 + 清理。
安全做法分两步走：
- 先查出可删的远程分支（已合并、非保护分支）：
git branch -r --merged origin/main | grep 'origin/feature/' | grep -v 'origin/HEAD\|origin/main\|origin/dev' - 再逐个推送空引用清理（别直接
xargs git push origin --delete，容易误伤）：
先用echo预览：git branch -r --merged origin/main | grep 'origin/feature/' | sed 's/origin\///' | xargs -I {} echo git push origin --delete {}
确认无误后，把echo换成真实命令执行
关键点：永远不要跳过预览步骤；分支名含斜杠（如 release/v2.3）无需引号，但含空格或特殊字符时必须加单引号包裹。
为什么 git pull 不会自动清理远程分支缓存
git pull 本质是 git fetch && git merge，它只拉取当前分支所需的对象和引用，不会扫描整个远程仓库的分支列表。也就是说，它只更新你正在用的那个分支的远程追踪引用（比如 origin/main），对其他已删分支（如 origin/old-feature）的本地缓存完全不管。
这也是为什么团队协作中，一个人删了远程分支，其他人不手动运行 git fetch --prune，就永远看不到变化——Git 的设计就是「状态分离」，本地缓存不会被动刷新。
最容易被忽略的一点：GitHub / GitLab 等平台的「Protected Branch」设置会导致 git push origin --delete 失败，报错类似 remote: error: unable to delete: protected branch。这时必须先去平台后台关掉保护，再删分支，否则后续所有清理动作都只是在原地打转。
