VSCode本地缓存是多个独立目录组成的临时数据集合,核心用于加速加载、避免重复请求、维持UI响应;Cache和GPUCache属Chromium渲染层缓存,CachedData存插件市场快照,workspaceStorage按工作区隔离存储索引,extensions中*-cache为更新残留,清理前须彻底退出所有进程。

VSCode本地缓存不是“一个东西”,而是多个独立目录里不同用途的临时数据集合,核心作用是加速加载、避免重复网络请求、维持UI响应速度——但它不负责保存你的配置或插件本体。
Cache 和 GPUCache:Chromium 渲染层的“快取货架”
这两个目录(Cache 和 GPUCache)是 Electron 底层 Chromium 生成的纯运行时缓存:
-
Cache存 HTTP 响应体(比如插件市场 JSON、图标 CDN 地址)、语法高亮渲染结果、Webview 资源;删了重启后自动重建,不影响设置或登录态 -
GPUCache是 GPU 加速渲染用的二进制快照,常达几 GB,卡顿/右键延迟/终端输入滞后往往就源于它老化;Windows 路径是%APPDATA%\Code\GPUCache,macOS/Linux 在~/Library/Caches/com.microsoft.VSCode或~/.cache/Code - 只清
Cache不清GPUCache,UI 卡顿大概率还在;反过来也一样
CachedData:插件市场的“离线快照”
这个目录(CachedData)存的是插件市场元数据的压缩包,含版本号、分类、截图 URL、安装统计等:
- 它和
Cache是分工关系:Cache存原始 HTTP 返回,CachedData存结构化快照;只删一个,Extensions 视图会卡在 “Loading…” 或显示过期信息 - 路径因系统而异:
%APPDATA%\Code\CachedData(Win)、~/Library/Application Support/Code/CachedData(macOS)、~/.config/Code/CachedData(Linux) - 删完首次打开 Extensions 页面变慢是正常现象——说明 VSCode 正在重新拉取并解压新快照
workspaceStorage:每个工作区的“私人索引库”
这不是传统意义的缓存,而是按工作区(文件夹)隔离存储的状态数据:
- 每个子目录对应一个你打开过的项目,名字是 GUID,内容包括文件搜索索引、调试快照、符号跳转缓存、最近打开文件列表
- 体积动辄几百 MB~几 GB,尤其对含
node_modules或 WSL 挂载路径的 monorepo;但删错不会丢.vscode/settings.json或launch.json - 安全清理方式是进
%APPDATA%\Code\User\workspaceStorage(Win)或对应路径,按“修改日期”排序,删掉 90 天以上未访问的子目录
extensions 目录里的 *-cache 文件夹:插件更新失败的“半成品遗骸”
VSCode 更新插件时,会先下载到临时 -cache 目录,再原子替换正式目录:
- 网络中断或强制退出会导致残留如
ms-python.python-2024.12.0-cache;VSCode 启动时尝试加载它,结果就是插件灰显、Failed to fetch、语言服务器起不来 - 只删结尾带
-cache的文件夹,别碰ms-python.python-2024.12.0这类正式版本目录——那是插件本体 - 某些插件还会在自己子目录里建
cache/或__pycache__/,需手动进入再清
真正容易被忽略的点是:所有这些目录都必须在完全退出 VSCode 进程后再操作。任务管理器里残留的 Code Helper (Renderer) 或 node.exe 会锁住文件句柄,导致删除失败或删完立刻重建。macOS/Linux 用 killall -9 Code,Windows 用 taskkill /f /im Code.exe,Remote - WSL 用户还得先 wsl --shutdown。











