workspacestorage 存储项目符号索引、搜索快照和断点映射,每个 guid 子目录对应一个打开过的文件夹;它非临时缓存,不自动清理,需按修改时间(如超90天)和体积(gb级)精准删除,删前须彻底关闭所有 vscode 进程,否则空间无法释放。

workspaceStorage 里存的就是项目索引,删它最直接
VSCode 的项目级符号索引、搜索快照、断点映射等,全存在 WorkspaceStorage 目录下,每个子文件夹对应一个你打开过的文件夹(名字是 GUID,比如 8a2b3c4d),不是临时缓存,但也不会自动清理。它不随 .vscode 文件夹删除而消失,反而越积越大——尤其你频繁切换分支或重开旧项目时,旧索引仍占着磁盘且可能失效。
- Windows 路径:
%APPDATA%\Code\WorkspaceStorage - macOS 路径:
~/Library/Application Support/Code/WorkspaceStorage - Linux 路径:
~/.config/Code/WorkspaceStorage
进目录后按「修改日期」排序,重点删那些修改时间早于 90 天、体积标着 “1.2 GB” 或 “2.7 GB” 的子目录。别靠名字猜项目——GUID 看不出来源,必须结合时间判断。
删前必须关死所有 VSCode 进程,否则白删
常见现象:删完发现 C 盘没释放空间,任务管理器里还挂着 Code.exe、node.exe 或 Code Helper。这些进程锁住文件句柄,系统无法回收磁盘空间。
- Windows:任务管理器 → 「详细信息」页 → 结束全部
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出所有匹配项(含Code Helper (Renderer)) - Linux:
pkill -f "code"或killall code - 如果用过 Remote-WSL:先在 VSCode 里执行
Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再终端运行wsl --shutdown
删错会怎样?重建慢,但不会崩
误删了某个还在用的项目对应的 WorkspaceStorage 子目录,后果很轻:下次打开该项目时,搜索跳转会卡顿几秒(索引重建中),语言服务响应略迟,但 .vscode/settings.json、launch.json 全部完好,插件状态、全局设置也不受影响。
- 不会丢配置:所有工作区配置都存在
.vscode文件夹里,和WorkspaceStorage无关 - 不会影响其他项目:每个子目录完全隔离,删 A 项目索引不影响 B 项目
- 首次重开变慢是正常现象,不是损坏——VSCode 就是这么设计的
别和 CachedData 搞混,它不存项目索引
CachedData 是预编译 JS 模块和语言服务中间产物,路径在 %LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData(Windows)或 ~/.config/Code/CachedData(Linux/macOS)。它影响启动速度和 UI 渲染,但和项目符号索引无关。清它不能解决「跳转不到定义」「搜索结果不准」这类问题——那是 WorkspaceStorage 的职责。
真正要清项目索引,只盯 WorkspaceStorage;想提速启动,才动 CachedData。两者目标不同,路径不同,混着删既没必要,也容易误伤。











