清理VSCode缓存可解决UI错位、补全失效等问题。先关闭VSCode,删除Cache、CachedData和GPUCache目录下的文件;问题未解决时可重命名扩展目录或备份后清除User数据;重启后若仍异常,可用code --disable-extensions --no-cached-data启动验证。

VSCode 出现奇怪的 UI 错位、自动补全失效、设置不生效等问题时,清理缓存通常能有效解决。这些现象有时是由于旧的或损坏的缓存数据导致的。以下是具体操作步骤。
关闭 VSCode 并找到缓存目录
要彻底清理缓存,先完全退出 VSCode(包括后台进程)。然后根据你的操作系统,进入对应的缓存路径:
- Windows:`%AppData%\\Code\\Cache` 和 `%AppData%\\Code\\CachedData`
- macOS:`~/Library/Application Support/Code/Cache` 和 `~/Library/Application Support/Code/CachedData`
- Linux:`~/.config/Code/Cache` 和 `~/.config/Code/CachedData`
这些目录中存放了渲染缓存、扩展加载缓存和语言服务临时数据。
删除缓存文件夹内容
进入上述目录后,你可以直接删除以下文件夹中的所有内容:
- Cache:浏览器级缓存,影响界面加载表现
- CachedData:VSCode 启动和扩展加载时生成的编译缓存
- GPUCache:图形渲染缓存,UI 显示异常时常与此有关
不需要删除整个文件夹,只需清空其内部文件即可。系统会在下次启动时重建。
可选:清除扩展和用户数据缓存
如果问题依然存在,可以进一步清理更深层的数据:
- 扩展缓存:路径为 `~/.vscode/extensions`(全局)或项目内的 `.vscode/extensions`,可尝试重命名该目录来触发重新安装
- User Data:包含设置同步和工作区状态,路径与 Cache 同级的 `User` 目录下,如 `workspace.json` 损坏可能导致布局错乱
注意:清理 User 数据前建议备份 settings.json 和 keybindings.json。
重启 VSCode 验证效果
清空缓存后,重新启动 VSCode。首次启动会稍慢,因为它需要重建缓存和索引。观察之前的问题是否消失。
若问题依旧,可尝试在启动时使用安全模式:
code --disable-extensions --no-cached-data
这能判断是否由扩展或缓存引起。
基本上就这些。定期清理缓存对维护 VSCode 稳定性有帮助,尤其在大版本升级后。不复杂但容易忽略。










