VSCode怎么清除编辑器的缓存文件

VSCode卡顿、启动慢、插件不生效？精准清理缓存是关键

遇到VSCode卡顿、启动变慢，或者插件突然失灵？先别急着怀疑自己的配置出了问题。很多时候，问题的根源并非代码写错，而是日积月累的缓存文件堆积，甚至个别缓存文件损坏了。直接删除整个缓存目录虽然痛快，但容易误伤扩展的配置状态或登录凭据，得不偿失。真正有效的做法，是精准定位并清理那几个关键的子目录。

先关进程，再动手删缓存目录

动手之前，有一个至关重要的前置步骤：彻底关闭VSCode及其所有后台进程。残留的 Code.exe（Windows系统）或 Code Helper（macOS/Linux系统）会锁住缓存文件，导致你删不干净，甚至可能引发报错。因此，必须确保进程完全退出：

• Windows用户：打开任务管理器，在“进程”和“详细信息”标签页中，找到并结束所有名为 Code.exe 的进程。
• macOS用户：打开“活动监视器”，在搜索栏输入 Code，将搜到的所有相关进程强制退出。
• Linux用户：在终端中运行 pkill -f "code" 或 killall code 命令。

确认没有任何残留进程后，再进入对应的缓存路径进行操作，否则很可能“删了也白删”。

只删这三个缓存子目录，别碰 User 和 Extensions 主目录

VSCode的缓存目录结构清晰，真正影响性能且可以安全删除重建的，主要是以下三个子目录：

• Cache 目录：存放的是Chromium渲染层的缓存，包括GPU缓存和资源快照。当编辑器出现明显卡顿、滚动不流畅时，这是首要清理对象。
• CachedData 目录：这里保存着预编译的Ja vaScript模块和语言服务的中间产物。处理大型项目时，这个目录容易积压大量数据，影响启动和响应速度。
• 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 子目录

如果遇到插件图标变灰、提示“Failed to fetch”或完全失效，通常不是插件本身损坏了。这往往是插件更新过程中意外中断，留下了一些不完整的临时缓存文件夹，例如 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？按时间清理，别全删

还有一个容易被忽视但可能占用巨量空间的位置：workspaceStorage。这个目录下的每个子文件夹都对应一个你曾经打开过的工作区或项目，里面存储的并非临时缓存，而是语言服务器的索引、全局搜索历史、调试会话快照等数据。虽然它们不是垃圾文件，但长期不清理会像滚雪球一样越积越大。

• 进入 %APPDATA%\Code\workspaceStorage（Windows）或 ~/.config/Code/workspaceStorage（Linux/macOS）。
• 按照“修改日期”进行排序，挑选出那些超过半年甚至一年没有打开过的项目子目录进行删除。
• 切勿全选清空：因为正在开发中的项目索引一旦被删除，下次打开时VSCode需要重新扫描和索引整个项目，可能会导致几分钟的卡顿，反而影响效率。

可以说，真正吞噬磁盘空间的大户，往往藏身于此，而非普通的 Cache 目录。但清理它的逻辑完全不同——核心策略是“识别并清理旧项目”，而非“一键清空所有”。