VSCode怎么清理本地已经删除但远端还存在的Git分支

VSCode本身并没有提供“清理本地已删但远端仍存在”的分支功能——原因很简单，这种分支压根就不存在。你看到的所谓“本地已删但远端还有”的分支，其实是一个常见的误解。在Git里，分支是轻量级的引用，你删除本地分支（git branch -d）并不会影响远端。而你在远程仓库看到的那些分支引用（比如 origin/feature/login），本质上是本地独立的远程跟踪引用。它们只有在远端分支被删除后，并且你执行了 git fetch --prune 或 git remote prune origin，才会被清理掉。

为什么 git branch -r 里还挂着 origin/xxx，但 GitHub/GitLab 上早就没了？

这是最常见的误判现场。你觉得远端分支还在，其实它早就被删了，只是你本地还留着那个过时的“stale”引用。

• git branch -r 显示的是本地 .git/refs/remotes/origin/ 目录下的文件，它并不是实时去远端查询的。
• VSCode 的源代码管理视图，读取的也是这些本地缓存，所以会表现出一段“滞后”时间。
• 关键在于，git fetch 默认不会去清理这些过时的引用。你必须显式地加上 --prune 参数，或者事后单独运行 git remote prune origin。
• 还有一个容易被忽略的点：如果 remote.origin.fetch 配置被修改过，比如只拉取特定分支，那么 --prune 也可能失效。

git fetch --prune 没清干净？试试 git remote prune origin

git fetch --prune 是“拉取新数据 + 清理旧引用”的组合操作，但它依赖当前的 refspec 范围。而 git remote prune origin 则不同，它直接扫描所有 origin/xxx 引用，逐一比对远端真实的分支列表，然后毫不犹豫地删除那些已经不存在的项。这，才是真正可靠的一步清理动作。

• 在项目根目录的终端里运行：git remote prune origin
• 如果想看具体删除了哪些，可以加个 -v 参数：git remote prune origin -v
• 如果你的远程仓库名不是 origin（比如叫 upstream），记得把命令里的 origin 替换掉。
• 放心，这个操作只清理 .git/refs/remotes/origin/ 下的文件，不会影响你的工作区、本地分支或任何提交历史。

让 VSCode 自动同步远端分支状态

VSCode 自带的 Git 扩展，默认是不会带上 --prune 参数的。但你可以通过配置，让它每次 fetch 都自动完成清理：

• 运行：git config --global fetch.prune true（全局生效，推荐）
• 或者只针对当前项目：git config fetch.prune true（仅当前仓库）
• 配置完成后，你在 VSCode 里点击“Fetch”、“Sync”，或者按 Ctrl+Shift+P 选择 Git: Fetch，都会等效于执行 git fetch --prune。
• 注意，这个配置并不会影响 git pull，因为 git pull 本质上是 fetch + merge，prune 只作用于 fetch 阶段。

真正容易被忽略的是：即使你删除了远端分支，自己也跑完了 git remote prune origin，但团队里的其他成员，只要他们没做过 fetch，也没配置 fetch.prune，他们本地的那个 origin/xxx 引用会一直保留下去。所以，清理这件事，不是一次性的操作，而是需要建立团队习惯或统一配置的。