清理VSCode缓存可解决卡顿、扩展失效等问题,需先关闭程序并备份设置、片段及扩展列表,再删除对应系统下的缓存目录。

当 VSCode 出现卡顿、扩展失效、界面错乱或自动补全异常等问题时,清理缓存通常能有效解决。这些现象很多是由于缓存数据损坏或版本不兼容导致的。直接重置缓存可以让编辑器恢复到较干净的状态。
关闭 VSCode 并备份重要数据
在操作前先完全退出 VSCode,确保没有后台进程运行。如果你使用的是 Windows,可在任务管理器中检查是否有 Code 相关进程;macOS 可通过活动监视器查看。如果有自定义设置或未同步的片段,建议提前备份以下目录:
- 用户设置文件:位于配置目录中的 settings.json
- 代码片段:保存在 snippets 文件夹中
- 已安装扩展列表:可通过命令行导出 code --list-extensions
删除 VSCode 缓存和配置目录
不同操作系统下,VSCode 的用户数据路径不同。找到并删除以下文件夹即可清除缓存和状态数据:
-
Windows:
C:\Users\{用户名}\AppData\Roaming\Code
同时可清理临时文件:C:\Users\{用户名}\AppData\Local\Temp\vscode-cached-data -
macOS:
~/Library/Caches/com.microsoft.VSCode -
Linux:
~/.config/Code
缓存路径:~/.cache/Code
删除这些目录后,VSCode 在下次启动时会重建它们,相当于一次“软重置”。
清理扩展和插件缓存
某些问题由第三方扩展引起。除了删除主配置目录,还可以单独处理扩展相关缓存:
- 进入扩展存储路径(通常为 ~/.vscode/extensions 或对应系统上的等效路径)
- 删除整个 extensions 文件夹,或仅移除怀疑有问题的扩展目录
- VSCode 重启后会重新下载安装的扩展
启动 VSCode 并重新配置
清空缓存后启动 VSCode,它会像首次运行一样初始化环境。此时可以重新登录 Microsoft/GitHub 账户,同步设置(如果启用了 Settings Sync),然后逐一验证问题是否解决。若一切正常,再逐步恢复自定义配置,便于排查潜在冲突。
基本上就这些。缓存清理不会影响项目文件,但能让编辑器运行更稳定。遇到奇怪行为时,这一步简单却常被忽略。










