必须先彻底杀掉所有VSCode进程再删缓存目录,否则磁盘空间不释放;Cache、GPUCache、CachedData可安全全删,重启自动重建;插件灰显需专清-extension目录下以-cache结尾的文件夹;workspaceStorage按修改时间清理90天前子目录。

必须先彻底杀掉所有 VSCode 进程,再删指定缓存目录——否则删了也白删,磁盘空间不释放,重启后缓存“复活”。
为什么删完 Cache 空间没变小?
常见错误现象:Cache、GPUCache 目录明明删了,任务管理器/活动监视器里却还看到 Code.exe、Code Helper.exe(Windows)或 Code Helper (Renderer)(macOS)在运行。这些进程锁住了文件句柄,系统无法回收空间。
- Windows:打开任务管理器 → “详细信息”页 → 结束全部
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出所有匹配项(含 GPU 和 Renderer 子进程) - Linux:终端执行
pkill -f "code"或killall code - 如果用过
Remote-WSL,务必先在 VSCode 里执行Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再运行wsl --shutdown
哪些缓存目录可以放心全删?
Cache、GPUCache、CachedData 是纯运行时产物,删完重启自动重建,不影响设置、插件启用状态或登录态。
-
Cache:Chromium 渲染层 HTTP 缓存 + UI 资源快照,路径为:
Windows:%APPDATA%\Code\Cache
macOS:~/Library/Caches/com.microsoft.VSCode/Cache
Linux:~/.cache/Code/Cache -
GPUCache:独立 GPU 渲染缓存,常达几 GB,路径同上 Caches 目录下(macOS/Linux),Windows 下为%APPDATA%\Code\GPUCache -
CachedData:预编译 JS 模块和语言服务中间产物,大项目易积压,路径为:
Windows:%LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData
macOS:~/Library/Application Support/Code/CachedData
Linux:~/.config/Code/CachedData
插件灰显或报 Failed to fetch?专清 *-cache 子目录
这不是插件坏了,而是更新中断后留下的半成品临时文件夹,比如 ms-python.python-2024.12.0-cache。VSCode 启动时尝试加载它,结果就是激活失败、语言服务器起不来。
- 路径统一为:
~/.vscode/extensions/(Windows/macOS/Linux 均适用) - 只删名字以
-cache结尾的文件夹,例如esbenp.prettier-vscode-12.5.0-cache - 别删
ms-python.python-2024.12.0这类不带-cache后缀的正式版本目录——那是插件本体 - PowerShell 快速筛选(Windows):
Get-ChildItem "$env:USERPROFILE\.vscode\extensions" | Where-Object {$_.Name -match '-cache$'} | Remove-Item -Recurse -Force
workspaceStorage 占几十 GB?按时间精准清理
这个目录里每个子文件夹对应一个你打开过的工作区,名字是 GUID,体积常达 1–5 GB。它不是临时缓存,但长期不清理会越滚越大——尤其 WSL 工作区、monorepo 或含 node_modules 的 Python 项目残留最肥。
- Windows 路径:
%APPDATA%\Code\User\workspaceStorage
macOS/Linux 路径:~/.config/Code/User/workspaceStorage(注意大小写) - 进目录后按“修改日期”排序,删除所有修改时间早于 90 天的子目录
- 重点盯体积标着
1.2 GB、2.7 GB的长名目录——大概率是已废弃项目残留 - 删错不会丢
.vscode/settings.json或launch.json,但首次重开该工作区时搜索和跳转会慢几秒(索引重建)
真正容易被忽略的是 Remote 插件和 AI 插件的本地模型缓存,它们往往藏在 %APPDATA%\Code\Remote 或 CachedData 子目录下,不单独处理,删完 Cache 也会很快涨回去。


















