VSCode卡顿、启动慢、插件不生效,主因是缓存堆积或损坏;应先彻底退出进程,再精准删除Cache、CachedData、GPUCache三个子目录,插件异常则删extensions下带-cache后缀的文件夹,workspaceStorage需按修改日期清理旧项目。

VSCode 卡顿、启动慢、插件不生效,八成不是配置写错了,而是缓存文件堆积或损坏了。直接删整个 Cache 目录看似痛快,但容易误伤扩展状态或登录凭据——真正该动的只有几个关键子目录。
先关进程,再动手删缓存目录
残留的 Code.exe(Windows)、Code Helper(macOS/Linux)会锁住文件,导致删不干净甚至报错。必须彻底退出:
- Windows:任务管理器 → 结束所有
Code.exe进程(包括后台“详细信息”页里的) - macOS:活动监视器 → 搜索
Code,强制退出全部相关进程 - Linux:终端运行
pkill -f "code"或killall code
确认无残留后,再进对应路径操作,否则删了也白删。
只删这三个缓存子目录,别碰 User 和 Extensions 主目录
这些是真正影响性能又可安全重建的缓存位置:
-
Cache:Chromium 渲染层缓存,含 GPU 缓存和资源快照,卡顿时首删项 -
CachedData:预编译的 JS 模块和语言服务中间产物,大项目易积压 -
GPUCache:独立于Cache的 GPU 渲染缓存,某些显卡驱动下会异常膨胀
路径参考:
- Windows:
%APPDATA%\Code\Cache、%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache - macOS:
~/Library/Caches/com.microsoft.VSCode、~/Library/Application Support/Code/CachedData - Linux:
~/.cache/Code、~/.config/Code/CachedData
删完直接重启 VSCode,它会自动重建,首次打开稍慢属正常。
插件报 Failed to fetch?专删 extensions 下的 *-cache 子目录
这不是扩展本身坏了,而是更新中断后留下的半成品临时文件夹,比如 ms-python.python-2024.8.0-cache。VSCode 启动时会尝试加载它们,结果就是插件灰显或报错。
- Windows 路径:
%USERPROFILE%\.vscode\extensions\ - macOS/Linux 路径:
~/.vscode/extensions/
只删名字带 -cache 后缀的文件夹,不要删 ms-python.python-2024.8.0 这类正式版本目录。删完重启,VSCode 会重新下载并解压,比“禁用再启用”更彻底。
workspaceStorage 占几十 GB?按时间清理,别全删
这个目录里每个子文件夹对应一个你打开过的工作区,里面存的是语言服务索引、搜索历史、调试快照等——不是临时文件,但长期不清理会越滚越大。
- 进
%APPDATA%\Code\workspaceStorage(Windows)或~/.config/Code/workspaceStorage(Linux/macOS) - 按“修改日期”排序,挑半年以上没打开过的子目录删除
- 别全选清空:正在开发的项目索引一旦丢失,首次打开要重新扫描整个项目,可能卡死几分钟
真正占空间的大户往往藏在这里,而不是 Cache;但清理逻辑完全不同——它靠的是“识别旧项目”,不是“一键清空”。


















