必须先彻底关闭所有vscode进程再删除cache、cacheddata、gpucache三个子目录,否则文件被锁定导致清理失败;插件异常则专删extensions下带-cache后缀的文件夹,workspacestorage和globalstorage也需按需清理。

关掉所有 VSCode 进程再删缓存目录
VSCode 的 Cache、CachedData、GPUCache 都是运行时自动生成的,但进程未完全退出时,Windows 会锁住文件,macOS/Linux 可能残留 Code Helper,导致删不干净或重启后缓存恢复失败。
必须执行以下操作:
- Windows:打开任务管理器 → “详细信息”页 → 结束所有
Code.exe和Code Helper.exe - macOS:活动监视器 → 搜索
Code→ 强制退出全部相关进程 - Linux:终端运行
pkill -f "code"或killall code
确认无残留后再进对应路径操作,否则删了也白删。
只删这三个子目录,别碰 User 和 Extensions
真正影响性能又可安全重建的是以下三个缓存位置,删完重启即自动重建,首次打开稍慢属正常:
-
Cache:Chromium 渲染层 HTTP 缓存 + 资源快照(路径:%APPDATA%\Code\Cache/~/Library/Caches/com.microsoft.VSCode/~/.cache/Code) -
CachedData:预编译 JS 模块和语言服务中间产物(路径:%LOCALAPPDATA%\Programs\Microsoft VS Code\CachedData/~/Library/Application Support/Code/CachedData/~/.config/Code/CachedData) -
GPUCache:独立 GPU 渲染缓存,常动辄几 GB(路径同Cache目录下子文件夹)
别删 User(含 settings.json)、Extensions 主目录——那是你的配置和插件本体,删了就真丢了。
插件报 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 会重新下载解压。
想彻底隔离缓存?用 --user-data-dir 启动新环境
手动删目录容易漏,尤其多用户或 CI 场景;更可控的方式是用命令行跳过旧缓存,直接启用干净沙箱:
code --disable-extensions --user-data-dir /tmp/vscode-test --no-sandbox
说明:
-
--user-data-dir指定全新用户数据路径(含缓存),原目录完全不受影响 -
--disable-extensions避免插件干扰,专注验证基础缓存是否健康 - Linux/macOS 用
/tmp/vscode-test;Windows 请改用C:\temp\vscode-test并确保路径存在
运行后关闭窗口,再用常规方式启动 VSCode,旧缓存就自然被弃用了——这个动作比“删完重启”更保险,因为连 workspaceStorage 和 globalStorage 的残留状态都不会继承。
重建缓存最易忽略的点是:workspaceStorage 和 globalStorage 不在常规缓存路径里,但它们可能存着损坏的 IntelliSense 索引或调试器适配器状态,卡顿反复出现时得一起清。











