必须先彻底结束vscode相关进程再删缓存目录,否则文件被锁、空间不释放;需清理cache、gpucache、cacheddata三个子目录及*-cache插件缓存,workspacestorage则按修改时间删除90天前的子目录。

直接删缓存目录前不杀干净进程,等于白干——Code.exe、Code Helper.exe、node.exe 任一残留都会锁住文件,导致删不掉、空间不释放、重启后问题照旧。
为什么任务管理器里删了还卡顿?
VSCode 基于 Electron,后台常驻多个进程:主进程、渲染进程、插件宿主、语言服务器(如 java 或 python 进程)、Remote-WSL 子系统。只关窗口不等于退出进程。
- 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 主目录——它们存的是配置和插件本体。真正该清的是以下三个子目录,它们体积大、易损坏、重启自动重建:
-
Cache:Chromium 渲染层缓存,含 UI 资源快照,卡顿时首删项(路径:%APPDATA%\Code\CacheWindows /~/Library/Caches/com.microsoft.VSCodemacOS /~/.cache/CodeLinux) -
GPUCache:独立 GPU 渲染缓存,某些显卡驱动下会异常膨胀到 2–5 GB(路径同上,但子目录名是GPUCache) -
CachedData:预编译 JS 模块和语言服务中间产物,大型项目易积压(路径:%LOCALAPPDATA%\Programs\Microsoft VS Code\CacheWindows /~/.config/Code/CachedDataLinux /~/Library/Application Support/Code/CachedDatamacOS)
插件报 Failed to fetch 或灰显?只动 *-cache 文件夹
这不是插件坏了,而是更新中断留下的半成品临时目录,比如 ms-python.python-2024.12.0-cache。VSCode 启动时会尝试加载它,结果就是语言服务器起不来、跳转失效。
- 路径统一在:
~/.vscode/extensions/(Windows/macOS/Linux 全适用) - 只删名字以
-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 {} +
WorkspaceStorage 占几十 GB?不能全删,得按时间筛
这个目录里每个子文件夹对应一个你打开过的工作区,存的是符号索引、搜索快照、调试上下文——不是临时文件,但 VSCode 从不自动清理旧项。名字是哈希值(如 8a2b3c4d),无法靠名字判断项目,只能看修改日期。
- 路径:
%APPDATA%\Code\WorkspaceStorage(Windows)/~/Library/Application Support/Code/WorkspaceStorage(macOS)/~/.config/Code/WorkspaceStorage(Linux) - 进目录后按“修改日期”排序,删除所有修改时间早于 90 天的子目录
- 重点盯住体积标着 “1.2 GB”“2.7 GB” 的子目录,尤其是已迁走的 WSL 发行版(如
ubuntu-20.04)对应项 - 删完重启 VSCode,首次重连该工作区会慢几秒重建索引,但 settings.json 和插件状态完全不受影响
最常被忽略的一点:删完 WorkspaceStorage 或 Cache 后磁盘空间没立刻变多,大概率是因为 node.exe 或 WSL 子系统仍在后台运行,文件句柄没释放。务必确认进程彻底退出,再检查空间变化。











