# 如何清理 IntelliJ IDEA 缓存

> 用 MangoDisk 查看 Windows 和 Mac 上的 IDEA 缓存占用，按需清理，保留项目、设置和本地历史记录。附 IntelliJ IDEA 自带清理入口与缓存位置。

项目没增加多少，C 盘却越来越满，IDEA 的缓存也值得检查。打开过的项目会留下索引和临时数据，这些文件通常不在代码目录里，关闭项目也不会顺带清空。

**清理 IDEA 缓存，不需要卸载软件，也不用删除项目或重置设置。** 保存工作、退出 IDE 后，只处理确认过的缓存。下次打开项目时，IDEA 可能需要重新建立索引，代码补全和跳转等功能要等索引就绪才能正常使用。

不想自己翻 AppData，可以用 [MangoDisk](/zh) 扫描 JetBrains 缓存，把大小和路径列出来，再选择值得清理的部分。免费开源，无需注册或登录。

## 用 MangoDisk 查看 IDEA 缓存占用

IDEA 自带的缓存清理入口适合处理索引问题；如果目的是腾空间，更有用的是先看清缓存在哪里、占了多少。MangoDisk 会集中显示支持的缓存目录，省去逐个打开文件夹、查看属性的麻烦。

打开[深度清理](/zh/docs/features/deep-clean)，完成标准扫描，在开发工具中找到 **JetBrains IDE 缓存**，展开查看路径和大小。电脑上装过多个版本，或同时使用 PyCharm、WebStorm 时，先按路径分清哪些属于 IDEA，不必把整组一起清掉。

![MangoDisk Windows 版深度清理界面，按类别查看缓存大小和路径并选择清理内容](https://assets.mangodisk.app/images/screenshots/windows/zh/light-01-deep-cleanup.jpg)

准备清理时：

1. 保存代码，停止构建任务，退出 IDEA 和其他正在使用的 JetBrains IDE。
2. 选择**暂不选择**，取消其他项目，只勾选核对过的 IDEA 缓存。
3. 检查预计释放空间和所选路径，确认后执行清理。

扫描不会自动删除文件。也不必把 JetBrains 缓存全部勾上：清理后可能需要重建，先看占用，再决定要不要清。

MangoDisk 在 Windows 上匹配默认目录中的缓存、索引、临时文件、日志和编译服务数据；Mac 上匹配部分可重新生成的缓存子目录。两边都排除项目、设置、插件和 **Local History（本地历史记录）**，不是直接清空整个 JetBrains 文件夹。[Windows 清理规则](https://github.com/harry0703/MangoDisk/blob/v1.1.6/src-tauri/crates/mangodisk-core/rules/filesystem/windows/development/dev.jetbrains-cache.toml) · [Mac 清理规则](https://github.com/harry0703/MangoDisk/blob/v1.1.6/src-tauri/crates/mangodisk-core/rules/filesystem/macos/development/dev.jetbrains-cache.toml)

清理会永久删除所选内容，不经过回收站或废纸篓。正在排查故障时，先保留相关日志；删除限制见[安全清理指南](/zh/docs/safety)。

## IDEA 缓存在哪里

默认位置如下，`<版本目录>` 代表实际安装版本的文件夹，例如 `IntelliJIdea2026.2`：

<table>
<thead>
  <tr>
    <th>
      系统
    </th>
    
    <th>
      缓存所在的系统目录
    </th>
    
    <th>
      查看方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Windows
    </td>
    
    <td>
      <code>
        %LOCALAPPDATA%\JetBrains\<版本目录>
      </code>
    </td>
    
    <td>
      粘贴到文件资源管理器地址栏
    </td>
  </tr>
  
  <tr>
    <td>
      Mac
    </td>
    
    <td>
      <code>
        ~/Library/Caches/JetBrains/<版本目录>
      </code>
    </td>
    
    <td>
      Finder 中按 <code>
        Shift + Command + G
      </code>
      
      ，粘贴路径
    </td>
  </tr>
</tbody>
</table>

**这些是外层目录，不是可以整包删除的缓存。** IDEA 的系统目录里还可能有 Local History，不要因为路径里出现 `Caches` 就全部清空。

如果改过存储位置，可以在 IDEA 的 **Help → Diagnostic Tools → Special Files and Folders** 中查看当前实际路径。MangoDisk 的标准扫描识别已知默认位置，不保证覆盖自定义的 `idea.system.path`。[JetBrains 目录说明](https://www.jetbrains.com/help/idea/directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)

有几类内容要留着：

- **项目源码和 .idea**：后者是项目配置，不要当作 IDE 缓存删除。
- **设置和插件目录**：Windows 通常在 `%APPDATA%\JetBrains`，Mac 通常在 `~/Library/Application Support/JetBrains`。
- **Local History**：可能保留尚未提交到 Git 的修改，不能当作普通缓存处理。

## 用 IDEA 自带入口清理缓存

如果遇到代码跳转失灵、索引异常，可以先用 IDEA 的 **File → Invalidate Caches…**，再选择 **Invalidate and Restart**。IDEA 会在重启时清理当前版本的项目缓存，之后按需重建。

不要顺手勾选 **Clear file system cache and Local History**，这个额外选项会连本地历史记录一起移除。使用默认选项清理缓存会保留 Local History；也不用为了腾空间勾选清除内置浏览器 Cookie 等无关选项。[JetBrains 缓存清理说明](https://www.jetbrains.com/help/idea/invalidate-caches.html)

只想修复当前 IDEA 的索引，用这个入口就可以。想比较多个版本、多个 IDE 的缓存占用，或者顺带检查其他开发工具，可以用 MangoDisk 集中查看，不用再挨个找目录。

## 清完 IDEA 缓存，磁盘还是很满

项目里的构建产物、Gradle 依赖和 npm 下载缓存，都是另一笔占用，不会随着 IDEA 缓存一起消失。

用 MangoDisk 的[磁盘空间分析](/zh/docs/features/disk-analysis)查看项目目录，先找出最大的文件夹。占用集中在 `.gradle` 时，可以接着看 [Gradle 缓存清理](/zh/blog/clear-gradle-cache)；Node.js 项目则参考 [npm 缓存与项目依赖的区别](/zh/blog/clean-npm-cache)。别反复清同一小块缓存，却漏掉真正占空间的目录。

[下载 MangoDisk](/zh)，先看看 IDEA 和其他开发工具的缓存占了多少。值得清的再处理，正在赶进度的项目也可以先留着。

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