VSCode卡顿主因是缓存堆积,应先彻底退出所有进程,再精准删除Cache、GPUCache、CachedData三个子目录及extensions下带-cache的文件夹,勿删User、GlobalStorage和workspaceStorage中的有效数据。

VSCode 卡顿、启动慢、右键响应迟滞,八成不是项目本身的问题,而是缓存堆积或损坏——但盲目删整个 Cache 目录反而可能引发扩展加载失败或登录态异常。真正该动的只有几个明确路径下的特定子目录,且必须先彻底退出进程。
删缓存前必须杀干净所有 VSCode 进程
Windows 任务管理器里残留的 Code.exe、Code Helper.exe 或 node.exe,macOS 活动监视器里没退出的 Code 相关进程,Linux 下未清理的 code 或 code-insiders,都会锁住缓存文件句柄。删了也白删,磁盘空间不释放,重启后缓存还“复活”。
- Windows:打开任务管理器 → “详细信息”页 → 结束全部
Code.exe、Code Helper.exe、node.exe - macOS:活动监视器 → 搜索
Code→ 强制退出所有匹配项 - Linux:终端执行
pkill -f "code"或killall code - 如果用过
Remote-WSL,务必先在 VSCode 中执行Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection,再运行wsl --shutdown
只删这三个缓存子目录,别碰 User 和 GlobalStorage
Cache、GPUCache、CachedData 是纯运行时产物,删完重启自动重建,不影响 settings.json、插件启用状态或微软账号登录态。它们长期不清理会直接导致 UI 卡顿、终端输入延迟、右键菜单卡住。
-
Cache:Chromium 渲染层 HTTP 缓存 + 资源快照,路径为%APPDATA%\Code\Cache(Win)、~/Library/Caches/com.microsoft.VSCode(macOS)、~/.cache/Code(Linux) -
GPUCache:独立 GPU 渲染缓存,常被忽略但动辄几 GB,路径同上 Caches 目录下(macOS/Linux),Win 下为%APPDATA%\Code\GPUCache -
CachedData:预编译 JS 模块和语言服务中间产物,大项目易积压,路径为%LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData(Win)、~/Library/Application Support/Code/CachedData(macOS)、~/.config/Code/CachedData(Linux)
别删 %APPDATA%\Code\User 或 %APPDATA%\Code\GlobalStorage —— 这里存着你的设置、Snippets、已信任工作区标记,误删等于重置全部偏好。
插件报 Failed to fetch 或灰显?专清 extensions 下的 *-cache 目录
这不是插件坏了,而是更新中断后留下的半成品临时文件夹,比如 ms-python.python-2024.12.0-cache。VSCode 启动时会尝试加载它,结果就是语言服务器起不来、补全失效。
- Windows 路径:
%USERPROFILE%\.vscode\extensions\ - macOS/Linux 路径:
~/.vscode/extensions/ - 只删名字结尾带
-cache的文件夹,比如ms-python.python-2024.12.0-cache - 绝对不要删
ms-python.python-2024.12.0这类正式版本目录——那是插件本体
删完重启,VSCode 会重新下载并解压,比“禁用再启用”更彻底。
workspaceStorage 占几十 GB?按修改日期精准删旧子目录
这个目录每个子文件夹对应一个你打开过的工作区(GUID 命名),里面存的是符号索引、搜索历史、调试快照——不是临时文件,但长期不清理会越滚越大。全删会丢掉所有工作区的本地状态(比如上次断点位置),但不会影响 .vscode/settings.json 或 launch.json。
- Windows 路径:
%APPDATA%\Code\WorkspaceStorage - macOS 路径:
~/Library/Application Support/Code/WorkspaceStorage - Linux 路径:
~/.config/Code/WorkspaceStorage - 进入后按“修改日期”排序,删除所有修改时间早于 90 天的子目录
- 重点盯体积标着 “1.2 GB”、“2.7 GB” 的长名目录——大概率是已废弃的 WSL 工作区、monorepo 或含大量
node_modules的 Python 项目残留
真正容易被忽略的是:删完后首次重开某个旧工作区,搜索和跳转会慢几秒,这是正常重建索引的过程;但如果删完立刻又涨回几 GB,大概率是你开着 Remote 开发或用了本地模型插件(如 ms-python.python),它们会在 CachedData 或 Remote 子目录另建缓存。



















