# VS Code 缓存怎么清理？

> 用 MangoDisk 查看 Windows 和 Mac 上的 VS Code 缓存大小与路径，按需清理扩展安装包和运行缓存；附手动清理方法及需要保留的目录。

VS Code 的缓存不都在安装目录里。下载过的扩展安装包、界面缓存和运行时生成的文件，会保存在用户目录中。想整理这些占用，不用卸载编辑器，也不用重装插件。

**先保存工作并退出 VS Code，再清理明确的缓存目录。** 下次打开时，部分缓存会重新生成，需要的扩展安装包也可能重新下载。别直接删除整个 `Code` 文件夹，里面还有需要保留的用户数据。

如果不想逐个翻目录，可以用 MangoDisk 扫描，直接查看这些缓存占了多少空间、放在哪里，再选择要清理的部分。

## 用 MangoDisk 查看和清理 VS Code 缓存

打开 MangoDisk 的[深度清理](/zh/docs/features/deep-clean)，完成扫描后，在「开发工具」中找到对应项目：

- **Windows**：展开「代码编辑器缓存」，查看 `Code` 目录下的缓存路径。
- **Mac**：展开「VS Code 缓存」，查看各个缓存目录的大小。

不用先记住 AppData 或 Library 的位置，也不用挨个打开文件夹查看属性。扫描结果会把路径和占用大小列出来，方便你先处理占用较大的缓存。

![MangoDisk 深度清理，在开发工具中查看代码编辑器缓存及其占用](https://assets.mangodisk.app/images/screenshots/windows/zh/light-01-deep-cleanup.jpg)

清理时按这几步操作：

1. 保存文件，停止正在运行的任务并退出 VS Code；Mac 上要退出应用，不只是关闭窗口。
2. 取消其他不准备清理的项目，只选择核对过的 VS Code 缓存路径。Windows 的「代码编辑器缓存」还可能包含 Cursor、Windsurf 等编辑器，不要把整组都选上。
3. 查看预计释放空间和需要关闭的程序，确认后执行清理。扫描本身不会删除文件。

这项清理不会把整个 VS Code 用户目录当作垃圾。Windows 的对应项目还包含日志和崩溃报告，正在排查故障时，可以先保留这些文件。

**清理是永久删除，不经过回收站或废纸篓。** 删除前检查所选路径，有疑问的文件先保留；恢复限制见[安全清理指南](/zh/docs/safety)。

## 手动清理 VS Code 缓存

常规安装的 VS Code，用户数据默认在下面的位置：

<table>
<thead>
  <tr>
    <th>
      系统
    </th>
    
    <th>
      默认目录
    </th>
    
    <th>
      打开方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Windows
    </td>
    
    <td>
      <code>
        %APPDATA%\Code
      </code>
    </td>
    
    <td>
      粘贴到文件资源管理器的地址栏
    </td>
  </tr>
  
  <tr>
    <td>
      macOS
    </td>
    
    <td>
      <code>
        ~/Library/Application Support/Code
      </code>
    </td>
    
    <td>
      Finder 中按 <code>
        Shift + Command + G
      </code>
      
      ，粘贴路径
    </td>
  </tr>
</tbody>
</table>

先退出 VS Code，再打开目录。可以优先检查这些文件夹的大小，按需清理其中的内容：

<table>
<thead>
  <tr>
    <th>
      文件夹
    </th>
    
    <th>
      内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        Cache
      </code>
      
      、<code>
        Code Cache
      </code>
      
      、<code>
        GPUCache
      </code>
    </td>
    
    <td>
      界面和运行时生成的缓存
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        CachedData
      </code>
    </td>
    
    <td>
      VS Code 生成的代码缓存，不是你的项目源码
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        CachedExtensionVSIXs
      </code>
    </td>
    
    <td>
      下载过的扩展安装包，不是已经安装的插件本体
    </td>
  </tr>
</tbody>
</table>

在 Windows 中，可以右键目标文件夹查看「属性」；在 Mac 中，选中文件夹后按 `Command + I` 查看大小。确认需要清理时，只删除目标缓存中的内容，不要连同外层 `Code` 文件夹一起删除。不确定的文件，先备份。

`User`、`Backups`、`Local Storage` 等目录，以及用户主目录下的 `.vscode/extensions`，不属于这里建议清理的缓存范围。VS Code 的[官方卸载说明](https://code.visualstudio.com/docs/setup/uninstall#clean-uninstall)把删除整个用户数据目录作为彻底卸载或重置的方法，不是日常缓存清理。

删除 `CachedExtensionVSIXs` 中的安装包，不等于卸载插件，之后需要时可以重新下载。依赖这些包做离线安装时，先留一份。[VS Code 官方扩展缓存说明](https://github.com/microsoft/vscode/issues/99873)

以上路径适用于默认位置的稳定版。如果用的是 Insiders、便携版，或通过 `--user-data-dir` 改过位置，以实际目录为准；MangoDisk 的上述规则不保证覆盖这些自定义位置。[自定义用户目录说明](https://code.visualstudio.com/docs/configure/command-line#advanced-cli-options)

## 空间的大头也可能在项目里

VS Code 缓存清完了，磁盘还是紧张，不一定是漏清。项目里的 `node_modules`、Rust 的 `target`、Gradle 的 `build`，以及下载的 AI 模型，都不是编辑器自身的缓存。

这时可以用 MangoDisk 的[磁盘空间分析](/zh/docs/features/disk-analysis)扫描项目所在目录。方块越大，占用越多，顺着大方块逐层查看，比反复清理几 MB 的缓存更容易找到空间的大头。

![MangoDisk 磁盘空间分析，通过矩形图查找占用较大的目录和文件](https://assets.mangodisk.app/images/screenshots/windows/zh/light-05-disk-space-analysis.jpg)

旧项目的依赖和构建文件，可以在「项目构建产物」中按项目检查；项目源码、需要留存的安装包和输出文件则应保留。具体可以参考 [npm 缓存与项目依赖的区别](/zh/blog/clean-npm-cache)和 [Cargo 缓存与 target 文件夹](/zh/blog/cargo-cache-vs-target-folder)。

清理缓存后，下一次启动可能要重新生成部分文件，不能保证编辑器因此变快。空间不紧张时，也没必要每次退出都清一遍。

[下载 MangoDisk](/zh)，把 VS Code 缓存和其他受支持的开发缓存集中检查，少翻目录，按需清理。免费开源，无需注册或登录，支持 Windows 和 macOS。

更多相关内容：[开发者磁盘清理指南](/zh/blog/topics/developer-cleanup)。