vscode启动慢、白屏、右键无响应,主因是缓存堆积或损坏,需先彻底终止所有相关进程(code.exe/code helper/node等),再精准删除cache、gpucache、cacheddata三个目录及extensions下以-cache结尾的文件夹,避免误删user、globalstorage和workspacestorage中有效数据。

VSCode 启动慢、卡在白屏、右键无响应,八成是缓存堆积或损坏,不是重装就能解决的——必须先杀进程、再精准删目录,否则删了也白删。
必须先彻底退出所有 VSCode 进程
残留的进程会锁住缓存文件,导致删除失败、磁盘空间不释放、重启后缓存“复活”。
- 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 和 GlobalStorage
Cache、GPUCache、CachedData 是纯运行时产物,删完重启自动重建,不影响设置、插件启用状态或登录态。误删 User 会导致 settings.json、Snippets、信任工作区全丢。
-
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 -match '-cache$'} | Remove-Item -Recurse -Force - macOS/Linux 终端命令:
find ~/.vscode/extensions -name "*-cache" -type d -exec rm -rf {} +
workspaceStorage 占几十 GB?按修改日期清理旧项目缓存
这个目录每个子文件夹对应一个你打开过的工作区,存的是语言服务索引、搜索历史、调试快照——不是临时文件,但长期不清理会越滚越大。全删会丢失所有工作区索引,得重新扫描,首次打开极慢。
- 路径参考:
Windows:%APPDATA%\Code\User\workspaceStorage
macOS:~/Library/Application Support/Code/WorkspaceStorage
Linux:~/.config/Code/WorkspaceStorage - 不要全删,用访达/文件管理器按“修改日期”排序,删掉半年以上没打开过的子文件夹
- 若某项目重启后索引异常,可单独删对应 GUID 子目录,VSCode 会自动重建
- 删完重启 VSCode,首次加载稍慢属正常;如果删完立刻又涨回几 GB,大概率是你开着
Remote-WSL或本地运行了 Ollama 模型插件,它们会在CachedData/Remote或CachedData/LocalModel下另建缓存,需进对应子目录再清
最容易被忽略的是:删完缓存后没杀干净进程,或者把 GlobalStorage 当缓存一起删了——后者存着 GitLens 的 commit 图谱、Pylance 的符号数据库路径等关键状态,一删就丢功能,且无法自动恢复。











