VSCode如何清理缓存文件_提升稳定性的维护操作

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

VSCode 启动卡顿或插件失效时，先清 Cache 目录

VSCode 的缓存文件（尤其是 Cache）长期积累会导致启动变慢、扩展加载失败、ui 渲染异常。这不是用户数据，删了不影响配置和工作区设置，但能快速缓解多数“莫名卡顿”问题。

关键路径取决于系统：

• windows：%appDATA%CodeCache
• macOS：~/Library/Caches/com.microsoft.VSCode
• linux：~/.config/Code/Cache

操作前确保 VSCode 已完全退出（包括右下角托盘进程）。直接删除整个 Cache 文件夹即可，下次启动会自动重建。

插件崩溃或更新后不生效，重点清理 CachedExtensions

VSCode 把已安装插件的解压副本存在 CachedExtensions，若插件更新中断或校验失败，这里可能残留损坏包，导致反复报错 Failed to fetch extension 或插件图标灰显。

对应路径：

• Windows：%USERPROFILE%.vscodeextensions 下的 *-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:tempvscode-test 并确保路径存在。

哪些缓存不能乱删？UserData 和 Extensions 主目录

很多人误以为删掉 User 或 extensions 根目录能“彻底清理”，结果丢失所有设置、快捷键、Snippets 和已安装插件。这些不是缓存，而是持久化数据：

• User/settings.json：你的全部自定义配置
• extensions/（不含 -cache 后缀的文件夹）：插件本体，删了就得重装
• Machine/ 和 GlobalStorage/：部分插件的本地状态（如 git history 记录、Prettier 缓存格式化结果）

真正安全的清理范围只有明确标为 Cache、CachedExtensions、或带 -cache 后缀的目录。其他一律不动。