vscode缓存过多是默认行为叠加长期使用的必然结果;必须先彻底终止所有code进程,再清理cache、gpucache、workspacestorage(按修改时间删90天前子目录)、extensions中*-cache后缀文件夹及cacheddata目录,否则无法释放空间且易引发卡顿。

VSCode缓存文件过多不是配置错误,而是默认行为叠加长期使用后的必然结果;直接删目录能释放空间,但必须先杀光所有相关进程,否则删了也白删。
Cache 和 GPUCache 目录为什么必须清、怎么清
这两个是 Chromium 渲染层产物,不随 VSCode 退出自动清理,也不按 LRU 淘汰——只要没手动删,就持续写入并膨胀。它们会导致 UI 卡顿、右键响应迟滞、终端输入延迟,尤其在打开大文件或预览 Markdown 后增长明显。
-
Cache存 HTTP 响应、Marketplace 页面资源、扩展市场搜索缓存 -
GPUCache是独立 GPU 渲染缓存,常被忽略但动辄几 GB - Windows 路径:
%APPDATA%\Code\Cache和%APPDATA%\Code\GPUCache - macOS 路径:
~/Library/Caches/com.microsoft.VSCode(注意不是 Application Support) - Linux 路径:
~/.cache/Code - 删完重启 VSCode,首次打开稍慢属正常,不会丢
settings.json或已打开文件
workspaceStorage 不能全删,得按时间筛旧项目
这个目录每个子文件夹对应一个你打开过的工作区(名字是 GUID),里面存符号索引、搜索历史、调试快照——不是临时文件,但长期不清理会越滚越大。一个废弃的 WSL 工作区或含 node_modules 的 Python 项目残留,体积常达 1–5 GB。
- Windows 路径:
%APPDATA%\Code\User\workspaceStorage - macOS/Linux 路径:
~/Library/Application Support/Code/WorkspaceStorage或~/.config/Code/WorkspaceStorage - 进目录后按“修改日期”排序,删除所有修改时间早于 90 天的子目录
- 别靠文件名判断归属,重点盯体积标着 “1.2 GB”、“2.7 GB” 的长名目录
- 删错表现:某项目“搜索全部文件”变慢、跳转定义偶尔失灵——说明索引没了,但所有配置和信任标记都还在
extensions 目录下只删带 -cache 后缀的损坏包
插件更新中断时会残留半成品临时文件夹,比如 ms-python.python-2024.12.0-cache。VSCode 启动时尝试加载它,结果就是灰显、Failed to fetch extension、语言服务器起不来。
- 路径统一在:
~/.vscode/extensions/(Windows/macOS/Linux 均适用) - 只删名字匹配
-cache$的文件夹,比如ms-python.python-2024.12.0-cache - 别碰
ms-python.python-2024.12.0这类正式版本目录,那是插件本体 - PowerShell 一行清理:
Get-ChildItem "$env:USERPROFILE\.vscode\extensions" | Where-Object {$_.Name -match '-cache$'} | Remove-Item -Recurse -Force - macOS/Linux 用:
find ~/.vscode/extensions -name "*-cache" -type d -exec rm -rf {} +
删完不释放空间?大概率是进程没杀干净
常见错误现象:删完 Cache 或 workspaceStorage 后任务管理器里仍看到 Code.exe、Code Helper.exe 或 node.exe 在运行——这些进程锁住了文件句柄,Windows/macOS/Linux 都无法立即回收空间。
- Windows:打开任务管理器 → “详细信息”页 → 结束所有
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出全部相关进程 - Linux:终端执行
pkill -f "code"或killall code - 如果用过
Remote - WSL,务必先在 VSCode 中执行Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再终端运行wsl --shutdown
真正容易被忽略的是 CachedData 目录——它藏在 %APPDATA%\Code\CachedData(Windows)或 ~/.config/Code/CachedData(Linux/macOS),存放预编译的 JS 模块和语言服务中间产物,大项目长期不开机后极易积压,且不包含在常规清理清单里。











