插件市场打不开或显示旧版本，需同时删除CachedData和Cache目录并确保VSCode完全退出；插件灰显或报错则专清*-cache子目录；清理后首次启动变慢属正常重建缓存现象。
插件市场打不开或显示旧版本？先清 CachedData 和 Cache
VSCode 插件市场（Extensions 视图）卡在“Loading”、搜不到新版本、图标/描述还是几个月前的，基本可以断定是本地缓存没清干净。它不是每次联网拉最新数据，而是优先读 CachedData（压缩快照）和 Cache（HTTP 响应体），两个目录必须一起删，只动一个会出半截状态。
-
CachedData存的是扩展元数据快照：版本号、分类、截图 URL、安装统计等，路径因系统而异：
Windows：%LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData
macOS：~/Library/Application Support/Code/CachedData
Linux：~/.config/Code/CachedData -
Cache存的是网络请求缓存：包括 marketplace 页面 HTML、扩展图标 PNG、JSON 接口返回体，路径：
Windows：%APPDATA%\Code\Cache
macOS：~/Library/Caches/com.microsoft.VSCode/Cache
Linux：~/.cache/Code/Cache - 删之前务必确认 VSCode 已完全退出——任务管理器里没有
Code.exe、Code Helper.exe、node.exe；macOS 用killall -9 Code；Linux 用pkill -f "code"，否则文件被锁，删了也白删
插件灰显或报 “Failed to fetch”？专清 *-cache 插件子目录
插件列表里某个扩展显示“已禁用”但图标灰着、点启用没反应，或者控制台报 Failed to fetch extension，大概率是更新中断后留下的半成品目录，比如 ms-python.python-2024.12.0-cache。VSCode 启动时会尝试加载它，结果就是激活失败、语言服务器起不来。
- 路径统一在用户级 extensions 目录：
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"，然后手动删
删完重启变慢？这是重建缓存的正常现象
清完 CachedData 和 Cache 后首次打开 Extensions 视图明显卡顿、搜索延迟、图标要等几秒才加载出来，别慌——这不是故障，是 VSCode 正在重新拉取并生成本地快照。这个过程可能持续 10–30 秒，取决于网络和扩展数量。
- 如果卡超过 2 分钟且 Network 面板里全是
403或ERR_CONNECTION_TIMED_OUT，说明不是缓存问题，而是网络被代理、hosts 劫持或企业防火墙拦截 - 可快速验证：Ctrl+Shift+I 打开开发者工具 → Network 标签页 → 在 Extensions 视图搜个关键词（如
eslint）→ 看是否有对gallery.visualstudio.com的200响应 - 删完别急着装插件，先确认 Marketplace 能正常加载，再操作其他
Remote-WSL 或本地模型插件会另建缓存，得单独处理
如果你用过 Remote-WSL、Dev Containers，或者装了带本地大模型的插件（如新版 ms-python.python），它们会在 CachedData 或 WorkspaceStorage 下新建子目录，比如 Remote-WSL-CachedData 或 python-language-server-cache。这些不会被常规清理覆盖，删完主缓存后空间很快又涨回去。
- Remote-WSL 用户：必须先在 VSCode 内执行 Ctrl+Shift+P → 输入
Remote-WSL: Close Remote Connection，再运行wsl --shutdown，最后再删缓存目录 - 本地模型插件：检查
CachedData目录下有没有明显命名含python、rust、cpp的子文件夹，体积常超 1GB，可直接删 - 删完重启后若发现某插件“语言服务器启动失败”，别重装，等它自动下载重建——只要网络通，几分钟内会恢复
真正麻烦的从来不是“该删哪个文件夹”，而是删之前有没有杀干净所有进程、删之后有没有验证网络是否真的通。这两个环节漏掉一个，清理就等于白做。
