清理缓存能修复代码提示,因CachedData目录存储语法树、符号表等关键元数据,损坏会导致语言服务器无法解析项目;需清理%APPDATA%\Code\CachedData、Cache、GPUCache(Windows)等三路径,切勿误删User或Extensions。

VSCode 本地缓存损坏是代码提示异常(如卡顿、不触发、提示空白、IntelliSense 失效)的高频根因,尤其在频繁更新插件或突然断电后。直接重装 VSCode 或禁用插件往往无效,关键得清理特定缓存目录。
为什么清理缓存能修复代码提示?
VSCode 的代码提示依赖语言服务器(如 TypeScript Server、Pylance)的元数据缓存,这些缓存存在 CachedData 目录中。一旦该目录下的 JSON 或二进制索引文件损坏,语言服务就无法正确解析项目结构,导致提示延迟或完全不出现。
-
CachedData存储语法树、符号表、类型定义等关键提示数据,损坏后Go to Definition和Hover也会失效 -
Cache影响 Marketplace 插件加载和配置同步,间接拖慢语言服务启动 -
GPUCache虽主要管渲染,但 Electron 渲染进程卡死时,UI 层会“假死”,表现为提示框弹不出
必须清理的三个缓存路径(Windows/macOS/Linux 全平台适用)
缓存位置因系统而异,但作用一致。务必关闭所有 VSCode 进程(包括后台 Code Helper),否则文件被占用删不掉。
- Windows:
%APPDATA%\Code\CachedData、%APPDATA%\Code\Cache、%APPDATA%\Code\GPUCache - macOS:
~/Library/Caches/com.microsoft.VSCode/CachedData等同级Cache和GPUCache - Linux:
~/.cache/Code/CachedData等同级Cache和GPUCache
注意:User、Extensions、logs 这些目录千万别删——它们存着你的设置、已装插件和日志,删了等于重装。
清理后仍无提示?检查语言服务是否真在运行
缓存清完重启,如果提示还是没恢复,说明语言服务本身没起来。打开命令面板(Ctrl+Shift+P),执行:
-
Developer: Toggle Developer Tools→ 切到 Console 标签页,看是否有ERR开头的报错,比如Cannot find module 'typescript' -
Developer: Show Running Extensions→ 找对应语言扩展(如ms-python.python),确认其Startup状态是Yes且没报错 - 终端里手动跑一次
tsc --version(TypeScript)或python -c "import jedi"(Python),验证底层工具链是否可用
缓存清理本身几秒就能做完,但真正容易被忽略的是:缓存损坏常和某个插件的异常退出耦合发生——比如 Copilot 在写入缓存时崩溃,会把整个 CachedData 目录锁死。所以清理后若问题复发,优先盯住最近启用或自动更新的插件,而不是反复删缓存。


















