VSCode启动卡顿或插件失效时,应优先清理Cache目录及CachedExtensions子目录;Cache路径因系统而异,删除后重启自动重建;仅删除带-cache后缀的插件缓存文件夹,勿动UserData和Extensions主目录。

VSCode 启动卡顿或插件失效时,先清 Cache 目录
VSCode 的缓存文件(尤其是 Cache)长期积累会导致启动变慢、扩展加载失败、UI 渲染异常。这不是用户数据,删了不影响配置和工作区设置,但能快速缓解多数“莫名卡顿”问题。
关键路径取决于系统:
- Windows:
%APPDATA%\Code\Cache -
macOS:
~/Library/Caches/com.microsoft.VSCode - Linux:
~/.config/Code/Cache
操作前确保 VSCode 已完全退出(包括右下角托盘进程)。直接删除整个 Cache 文件夹即可,下次启动会自动重建。
插件崩溃或更新后不生效,重点清理 CachedExtensions
VSCode 把已安装插件的解压副本存在 CachedExtensions,若插件更新中断或校验失败,这里可能残留损坏包,导致反复报错 Failed to fetch extension 或插件图标灰显。
对应路径:
- Windows:
%USERPROFILE%\.vscode\extensions\下的*-cache子目录(如ms-python.python-2024.8.0-cache) - macOS / Linux:
~/.vscode/extensions/中带-cache后缀的文件夹
不要删整个 extensions 目录——只删含 -cache 的子文件夹。重启 VSCode 后,它会重新下载并解压插件,比强行重装插件更干净。
用命令行强制重建全部缓存(适合批量维护)
手动删目录容易漏,尤其多用户或 CI 环境。VSCode 提供了内置命令行参数,可跳过 UI 直接重置缓存状态:
code --disable-extensions --user-data-dir /tmp/vscode-test --no-sandbox
这条命令的作用是:
-
--user-data-dir指定全新用户数据路径(含缓存),原目录不受影响 -
--disable-extensions避免插件干扰,专注验证基础缓存是否健康 - 运行后关闭窗口,再用正常方式启动 VSCode,旧缓存就自然被弃用了
注意:/tmp/vscode-test 是临时路径,Linux/macOS 可用;Windows 请改用 C:\temp\vscode-test 并确保路径存在。
哪些缓存不能乱删?UserData 和 Extensions 主目录
很多人误以为删掉 User 或 extensions 根目录能“彻底清理”,结果丢失所有设置、快捷键、Snippets 和已安装插件。这些不是缓存,而是持久化数据:
-
User/settings.json:你的全部自定义配置 -
extensions/(不含-cache后缀的文件夹):插件本体,删了就得重装 -
Machine/和GlobalStorage/:部分插件的本地状态(如 Git History 记录、Prettier 缓存格式化结果)
真正安全的清理范围只有明确标为 Cache、CachedExtensions、或带 -cache 后缀的目录。其他一律不动。









