删缓存前必须彻底终止code.exe和node.exe等进程,否则文件被锁导致空间不释放;cache和gpucache可安全删除,重启自动重建;extensions中只删-cache后缀文件夹;workspacestorage按修改日期清理旧子目录。

删缓存前必须杀光所有 Code.exe 和 node.exe 进程
不关干净就删,Windows/macOS/Linux 都会卡住空间不释放——文件被进程锁着,删了也白删。任务管理器里看到 Code.exe、Code Helper.exe、node.exe(尤其 Remote-WSL 场景下),一个都不能留。
Windows:进“详细信息”页,全选并结束所有 Code.exe 及相关进程
macOS:活动监视器搜 Code,强制退出全部
Linux:pkill -f "code" 或 killall code
Remote-WSL 用户额外加一步:Ctrl+Shift+P → 输入 Remote-WSL: Close Remote Connection,再终端跑 wsl --shutdown
Cache 和 GPUCache 可全删,重启自动重建
这两个是纯运行时缓存,不影响 settings.json、插件启用状态或登录态。长期不清理会导致 UI 卡顿、右键响应慢、终端输入延迟。
-
Cache:Chromium 渲染层 HTTP 缓存 + 资源快照,路径:%APPDATA%\Code\Cache(Win)、~/Library/Caches/com.microsoft.VSCode(macOS)、~/.cache/Code(Linux) -
GPUCache:独立 GPU 渲染缓存,常被忽略但动辄几 GB,路径:%APPDATA%\Code\GPUCache(Win)、同上 Caches 目录下(macOS/Linux)
删完重启 VSCode,首次打开稍慢属正常;如果删完立刻又涨回几 GB,大概率是你开着 Remote 开发或用了本地模型插件(如 ms-python.python),它们会在 CachedData 或 Remote 子目录另建缓存。
extensions 目录下只删带 -cache 后缀的文件夹
插件更新中断后会残留半成品目录,比如 ms-python.python-2024.12.0-cache。VSCode 启动时尝试加载它,结果就是灰显、Failed to fetch、语言服务器起不来。
Windows 路径:%USERPROFILE%\.vscode\extensions\
macOS/Linux 路径:~/.vscode/extensions/
- 只删名字结尾是
-cache的文件夹,比如ms-python.python-2024.12.0-cache - 别碰
ms-python.python-2024.12.0这类正式版本目录,那是插件本体 - 某些插件还会在自己子目录里建
cache/或__pycache__/,可手动进对应文件夹再清
workspaceStorage 占几十 GB?按修改日期精准删旧子目录
这个目录每个子文件夹对应一个你打开过的工作区,存的是语言服务索引、搜索历史、调试快照——不是临时文件,但长期不清理会越滚越大。全删会丢掉所有工作区的本地状态(比如上次断点位置、搜索高亮记录)。
路径:%APPDATA%\Code\workspaceStorage(Win)、~/.config/Code/workspaceStorage(Linux/macOS)
- 进目录后按“修改日期”排序,挑半年以上没动过的子文件夹删
- 别删正在用的项目对应的文件夹(看名称或进子目录查
workspace.json里的id字段) - 删之前建议先用命令行确认大户:
Get-ChildItem -Directory | ForEach-Object { $size = (Get-ChildItem $_.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum; [PSCustomObject]@{Folder=$_.Name; SizeMB=[math]::Round($size/1MB, 2)} } | Sort-Object SizeMB -Descending | Select-Object -First 5
真正容易被忽略的是:删完 workspaceStorage 后,下次打开对应工作区,语言服务要重新索引,可能卡几秒——这不是失败,是重建过程。











