vscode工作区加载慢等问题八成源于workspacestorage中某个旧工作区缓存损坏或膨胀，可通过powershell（windows）或du命令（macos/linux）定位并删除最大guid子目录，重启后自动重建索引且不丢失配置。
VSCode 工作区加载慢、搜索卡顿、符号跳转失效，八成不是项目本身的问题，而是 workspaceStorage 目录里某个旧工作区的缓存已损坏或膨胀到几 GB —— 它不随关闭项目自动清理，也不受 files.watcherExclude 控制。
怎么定位哪个 workspaceStorage 子目录最占空间
每个打开过的文件夹都会在 workspaceStorage 下生成一个 GUID 命名的子目录，里面存着该工作区的搜索索引、符号缓存、调试快照等。时间一长，废弃项目残留的目录可能比当前项目还大。
- Windows：打开 PowerShell，运行
cd "$env:APPDATA\Code\User\workspaceStorage"; Get-ChildItem -Directory | ForEach-Object { $size = (Get-ChildItem $_.FullName -Recurse -File -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum).Sum; [PSCustomObject]@{Folder=$_.Name; SizeMB=[math]::Round($size/1MB, 2)} } | Sort-Object SizeMB -Descending | Select-Object -First 5 - macOS/Linux：终端执行
du -sh ~/.config/Code/User/workspaceStorage/*/ | sort -hr | head -5 - 结果里排第一的往往是个半年没碰过的前端 monorepo 或 Python venv 全量扫描残留，直接删掉它，重启 VSCode 后对应工作区首次打开会重建缓存，但后续就轻了
删 workspaceStorage 会不会丢我的 launch.json 或 settings.json
不会。workspaceStorage 只存运行时生成的数据（比如 Ctrl+Shift+P 搜索历史、Go to Symbol 的索引、调试断点位置映射），不存任何你手动写的配置文件。
-
.vscode/launch.json、.vscode/settings.json都在项目根目录下，和workspaceStorage完全无关 - 真正存配置的是
%APPDATA%\Code\User\settings.json（全局）和项目内.vscode/文件夹（工作区级），这两个绝对不能进workspaceStorage里找 - 删错目录的典型症状：重启后某项目“搜索全部文件”变慢、跳转定义偶尔失灵——说明索引没了，但所有配置、扩展状态、甚至已信任的工作区标记都还在
为什么删完 workspaceStorage 还是很快涨回去
因为 VSCode 默认对整个工作区递归建立索引，尤其当你没配 files.watcherExclude 或 search.exclude 时，node_modules、dist、__pycache__ 全被扫进去，一次 Ctrl+Shift+F 就能再塞几百 MB 进去。
- 必须在用户设置或工作区设置里加：
"files.watcherExclude": {"**/node_modules/**": true, "**/dist/**": true} - 再补上：
"search.exclude": {"**/node_modules": true, "**/*.log": true} - Python 用户额外注意：
ms-python.python插件若没配pyrightconfig.json，会在workspaceStorage里缓存整个 venv 的类型信息——加个空配置文件就能禁用全量扫描
Remote-SSH 或 Dev Container 下的 workspaceStorage 在哪
不在本地 workspaceStorage 里。远程场景下，VSCode 会在远端机器的 ~/.vscode-server/data/Machine/（Linux/macOS）或 %USERPROFILE%\.vscode-server\data\Machine\（Windows Remote）下建独立缓存，和本地完全隔离。
- 本地删光
workspaceStorage对远程性能没影响 - 远程卡顿时，要 SSH 登上去，进远端的
.vscode-server/data/Machine/，按修改时间排序，删掉最老的几个 GUID 目录 - Dev Container 还多一层：容器内
/workspaces/xxx/.vscode-server/也会有缓存，docker exec -it xxx sh进去删更准
真正难清理的从来不是单个目录，而是那些你记不清什么时候打开过、又没关掉的临时工作区——它们静默躺在 workspaceStorage 里，每天默默拖慢搜索和启动。定期跑一遍大小排序，比等它崩了再重装强得多。
