Git仓库状态不更新,主因是VSCode缓存了过期的.git/index快照和workspaceStorage中的SCM状态;需关闭所有VSCode进程后,删除.git/index及对应GUID目录下的scm/文件夹,并确保git.path和git.autoRepositoryDetection配置正确。

Git 仓库状态不更新?先清 .git/index 和 VSCode 的 SCM 缓存
VSCode 的源代码管理(SCM)视图卡在“Loading…”、文件状态不刷新(比如修改后仍显示未更改)、或右下角分支名不更新,往往不是 Git 本身出问题,而是 VSCode 自己缓存了过期的索引快照。它不会实时监听 .git/index 变化,而是定期读取并缓存在内存和磁盘中。
真正要动的是两个地方:.git/index(Git 原生索引文件,可安全重建)和 VSCode 在 workspaceStorage 里为该项目存的 SCM 状态快照。只刷新窗口或重启 VSCode 不一定生效——因为 workspaceStorage 里的缓存可能已损坏。
- 先关掉当前项目的所有 VSCode 窗口(包括后台进程),否则
workspaceStorage子目录被锁住,删不干净 - 进项目根目录,运行
git update-index --refresh或直接删.git/index(Git 会在下次命令中自动重建,无风险) - 定位
workspaceStorage中对应项目的 GUID 子目录(路径见下一条),进其子文件夹找名为scm或含git字样的 JSON/DB 文件,整条scm文件夹可删
删哪个 workspaceStorage 子目录?按修改时间找,别猜名字
workspaceStorage 目录下每个 GUID 文件夹对应一个打开过的项目,但名字不带项目名,靠猜容易删错。VSCode 不会自动清理旧项目缓存,长期下来这里可能堆积几十 GB,其中 SCM 状态就藏在子目录的 scm 或 git 相关文件里。
正确做法是进目录后按「修改日期」排序,找到和你刚关闭的项目最后编辑时间最接近的那个 GUID 文件夹。Windows 路径:$env:APPDATA\Code\User\workspaceStorage;macOS/Linux:~/.config/Code/User/workspaceStorage 或 ~/Library/Application Support/Code/WorkspaceStorage。
- 删之前确认 VSCode 已完全退出(任务管理器/活动监视器里没有
Code或Electron进程) - 进该 GUID 文件夹后,优先删
scm/子目录(如有);若没有,可删整个文件夹——下次打开项目时会重建,只是首次加载搜索和状态略慢 - 别删
workspaceStorage根目录下的其他文件(如state.vscdb),那是全局工作区元数据,误删会导致所有项目状态丢失
右下角分支名卡死或显示错误?检查 git.path 和 git.autoRepositoryDetection
分支名不更新,有时根本不是缓存问题,而是 VSCode 找错了 Git 二进制或没识别到子模块。它默认用内置 Git,但如果你改过 git.path 配置,或项目用了 submodule,就可能因路径失效或检测逻辑跳过而卡住。
- 打开设置,搜
git.path,确保指向有效的 Git 可执行文件(如/usr/bin/git或C:\Program Files\Git\bin\git.exe) - 搜
git.autoRepositoryDetection,设为true(默认值),否则 VSCode 可能跳过嵌套 Git 仓库 - 如果项目含 submodule,确认
git.submoduleRecursive是否启用;禁用时,父仓库的 SCM 视图不会反映子模块变更 - 改完设置后,必须执行
Developer: Reload Window,仅重启终端或刷新 SCM 视图无效
删完还是不认 Git?顺手清 Cache 里的 Git 相关响应体
VSCode 的 SCM 视图底层调用 Git CLI,但部分元数据(如远程分支列表、提交历史摘要)会被缓存在 Cache 目录的 HTTP 响应体里。尤其当你切换网络环境(比如从公司内网切到家用 Wi-Fi),旧缓存可能包含 401 或超时响应,导致“Fetching origin”一直转圈。
这个缓存不在项目内,而在全局 Cache 目录中,格式是二进制 blob,没法手动挑 Git 相关的删,只能整目录清——但必须确保 VSCode 已彻底退出,否则删不净。
- Windows:删
$env:APPDATA\Code\Cache\* - macOS:删
~/Library/Caches/com.microsoft.VSCode/* - Linux:删
~/.cache/Code/* - 删完重启 VSCode,首次打开 SCM 视图会稍慢,这是它在重新拉取远程 refs 和本地 commit 图,属正常
真正麻烦的不是删哪几个文件,而是删的顺序和时机:进程没关干净 → 缓存删不净 → 重建时复用坏数据 → 问题依旧。每次清理前,先用任务管理器或 killall -9 Code 确认零残留,比多删十个目录都管用。


















