VSCode本地缓存损坏会导致启动白屏、插件图标消失等严重问题,必须先终止Code.exe/Code Helper/node.exe等进程,再精准清理Cache、CachedData、GPUCache和主程序Cache四个目录,切勿误删User和Extensions。

VSCode本地缓存损坏不是“偶尔卡一下”的小问题,而是会直接导致启动白屏、插件图标消失、右键无响应、Failed to fetch、甚至报 Invalid file descriptor to ICU data 这类底层崩溃——它不靠重装解决,必须精准定位并清理特定目录。
先杀进程,再删缓存,否则删了也白删
残留的 Code.exe(Windows)、Code Helper(macOS/Linux)或 node.exe 进程会锁住缓存文件,导致删除失败、磁盘空间不释放、重启后缓存“复活”。
- Windows:任务管理器 → “详细信息”页 → 结束全部
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出所有匹配项(含Code Helper (Renderer)和Code Helper (GPU)) - Linux:终端执行
pkill -f "code"或killall code - 若用过
Remote-WSL,务必先在 VSCode 中执行Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再运行wsl --shutdown
只删这四个缓存目录,别碰 User 和 Extensions
VSCode 缓存分散在多个路径,漏掉一个就白清;误删 User 或 Extensions 则等于重装配置和插件。
-
%APPDATA%\Code\Cache(Windows)或~/Library/Caches/com.microsoft.VSCode/Cache(macOS)或~/.cache/Code/Cache(Linux):Chromium 渲染层 HTTP 缓存,删后 Marketplace 加载稍慢,但不影响设置 -
%APPDATA%\Code\CachedData(Windows)或~/Library/Application Support/Code/CachedData(macOS)或~/.config/Code/CachedData(Linux):语法高亮、语义 token、语言服务中间产物,损坏会导致补全失效、跳转异常 -
%APPDATA%\Code\GPUCache(Windows)或同上 Caches 目录下(macOS/Linux):GPU 渲染加速缓存,常达几 GB,白屏/卡转圈高频诱因 -
%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache(Windows)或/Applications/Visual Studio Code.app/Contents/MacOS/../Cache(macOS):主程序级二进制缓存,和 Electron 渲染强相关,不清理这个,有时 Roaming 下清了也无效
⚠️ 绝对不要删:%APPDATA%\Code\User(含 settings.json、登录态、快捷键)、%USERPROFILE%\.vscode\extensions(插件本体目录)——那是你辛辛苦苦配好的东西。
插件图标不显示?专清 extensionsCache
插件市场空白、已安装插件没图标、点 Install 没反应,大概率不是网络问题,而是 extensionsCache 元数据损坏。它负责告诉 VSCode “有哪些插件可用”,一旦出错,整个 Marketplace 视图就成空壳。
- 路径:
%USERPROFILE%\.vscode\extensionsCache(Windows)或~/.vscode/extensionsCache(macOS/Linux) - 删完必须彻底退出 VSCode 再重启,不能只
Developer: Reload Window——它是进程启动时一次性加载的 - 如果仍不生效,进
~/.vscode/extensions检查插件文件夹是否被设为“只读”,或是否存在ms-python.python-2026.8.0-cache这类带-cache后缀的半成品文件夹(直接删)
磁盘满或权限不足时,额外清理 workspaceStorage 和禁用高危插件
当报 ENOSPC、EPERM、EACCES 或 Node 环境写缓存失败时,光清上面四个还不够——workspaceStorage 是 C 盘最大“隐形杀手”,而某些插件会在磁盘快满时继续强行写入。
-
%APPDATA%\Code\User\workspaceStorage(Windows)或~/Library/Application Support/Code/WorkspaceStorage(macOS):每个打开过的文件夹一个 GUID 目录,存搜索索引和符号缓存,常达 1–3 GB,可放心删 - 临时禁用这些高危插件:
ms-python.python(建cache/和__pycache__/)、esbenp.prettier-vscode(大文件保存时爆写中间产物)、eamodio.gitlens(后台持续扫描 Git 历史) - 禁用方式:命令面板输入
Extensions: Disable All Installed Extensions,重启后再逐个启用验证
真正难处理的,是那些删了缓存却仍不重建的场景——比如 icudtl.dat 被安全软件拦截、或 argv.json 里错误启用了沙箱/远程调试参数。这种时候,得看日志,而不是继续删。


















