VSCode 启动慢、白屏、卡顿、插件灰显,主因是缓存堆积或损坏,须先终止所有相关进程(Code.exe/Code Helper.exe/node.exe等),再精准清理Cache、GPUCache、CachedData、extensions下的*-cache文件夹及旧WorkspaceStorage子目录。

VSCode 启动慢、白屏、右键卡顿、插件灰显,八成不是配置问题,而是本地缓存堆积或损坏——删错目录没用,不杀进程白删,必须按路径类型精准清理。
必须先彻底终止所有 VSCode 相关进程
残留的 Code.exe、Code Helper.exe(含 GPU/Renderer/Plugin 后缀)、node.exe 会锁住缓存文件,导致删除失败、磁盘空间不释放、重启后缓存“复活”。
- Windows:任务管理器 → “详细信息”页 → 结束全部
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出所有匹配项(尤其Code Helper (GPU)和Code Helper (Renderer)) - Linux:终端执行
pkill -f "code"或killall code - 若用过
Remote-WSL:先在 VSCode 中执行Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再运行wsl --shutdown
只删这三个核心缓存目录,别碰 User 和 GlobalStorage
Cache、GPUCache、CachedData 是纯运行时产物,删完重启自动重建,不影响 settings.json、插件启用状态或登录态。误删 User 会导致设置、代码片段、信任工作区全丢。
-
Cache:Chromium 渲染层 HTTP 缓存 + 资源快照
Windows:%APPDATA%\Code\Cache
macOS:~/Library/Caches/com.microsoft.VSCode/Cache
Linux:~/.cache/Code/Cache -
GPUCache:独立 GPU 渲染缓存,常达几 GB
路径同上Caches目录(macOS/Linux),Windows 下为%APPDATA%\Code\GPUCache -
CachedData:预编译 JS 模块和语言服务中间产物,大项目易积压
Windows:%LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData
macOS:~/Library/Application Support/Code/CachedData
Linux:~/.config/Code/CachedData
插件灰显或报 Failed to fetch?专清 extensions 下的 *-cache 文件夹
这不是插件坏了,而是更新中断后留下的半成品临时文件夹,比如 ms-python.python-2024.12.0-cache。VSCode 启动时尝试加载它,结果就是激活失败、语言服务器起不来。
- Windows 路径:
%USERPROFILE%\.vscode\extensions\ - macOS/Linux 路径:
~/.vscode/extensions/ - 只删名字以
-cache结尾的文件夹,例如esbenp.prettier-vscode-12.5.0-cache - 别删
ms-python.python-2024.12.0这类不带-cache后缀的正式版本目录——那是插件本体 - PowerShell 快速筛选(Windows):
Get-ChildItem "$env:USERPROFILE\.vscode\extensions" | Where-Object Name -like "*-cache"
WorkspaceStorage 占几十 GB?按修改时间精准删旧子目录
WorkspaceStorage 是 C 盘空间最大头目,每个子目录对应一个你打开过的文件夹(名字是 GUID),无法靠名称判断归属,但修改时间基本等于你最后一次打开该工作区的时间。
- 路径:
%APPDATA%\Code\WorkspaceStorage(Windows)、~/Library/Application Support/Code/WorkspaceStorage(macOS)、~/.config/Code/WorkspaceStorage(Linux) - 进入后按“修改日期”排序,选中所有修改时间早于 90 天的子目录删除
- 重点盯体积标着
1.2 GB、2.7 GB的长名目录——大概率是已废弃的 WSL 工作区、monorepo 或含大量node_modules的 Python 项目残留 - 删错不会丢
.vscode/settings.json或launch.json,但首次重开该工作区时搜索和跳转会慢几秒(索引重建)
最常被忽略的是 CachedData 和 WorkspaceStorage ——它们不显眼,但长期不清理会让启动变慢、插件反复崩溃;还有人把 %USERPROFILE%\.vscode 和 %APPDATA%\Code 当成一回事,其实前者只存扩展,后者才管全局设置和缓存。











