修改IntelliJ IDEA开发工具的缓存目录

修改 IntelliJ IDEA 的缓存目录是一个非常好的习惯,不仅能释放 C 盘(系统盘)空间,还能降低系统盘的 I/O 负担,提升 IDE 的响应速度。

以下是安全、无损迁移 IDEA 缓存与配置目录的完整步骤:

第一步:准备工作

  1. 彻底关闭 IDE:确保 IDEA 及其后台进程(如 JetBrains Toolbox)均已完全关闭,防止文件被占用。
  2. 创建目标文件夹 :在 D 盘或其他非系统盘创建一个专属目录,例如 D:\JetBrains\IDEA。在该目录下手动创建两个子文件夹:
    • config(用于存放配置)
    • system(用于存放缓存)

第二步:复制现有数据

  1. 迁移配置数据
    • Win + R 键,输入 %APPDATA%\JetBrains 并回车。
    • 找到对应版本的文件夹(如 IntelliJIdea2026.1),将其中的所有文件 复制,粘贴到 D:\JetBrains\IDEA\config 中。
  2. 迁移缓存数据
    • Win + R 键,输入 %LOCALAPPDATA%\JetBrains 并回车。
    • 找到对应版本的文件夹,将其中的所有文件 复制,粘贴到 D:\JetBrains\IDEA\system 中。

第三步:修改配置文件

  1. 在桌面右键点击 IDEA 图标,选择"打开文件所在的位置",进入 bin 文件夹。
  2. 使用文本编辑器(如记事本)打开 idea.properties 文件。
  3. 找到以下被 # 注释掉的配置项,删除 # 号并修改路径
XML 复制代码
# 配置文件路径
idea.config.path=D:/JetBrains/IDEA/config
# 系统缓存路径
idea.system.path=D:/JetBrains/IDEA/system
# 插件路径(建议跟随config)
idea.plugins.path=D:/JetBrains/IDEA/config/plugins
# 日志路径(建议跟随system)
idea.log.path=D:/JetBrains/IDEA/system/log

⚠️ 核心注意 :Windows 系统下路径必须使用正斜杠 / ,绝对不能使用反斜杠 \

第四步:验证与清理

  1. 重启 IDE:重新启动 IDEA,观察是否能正常加载之前的配置和插件。
  2. 验证路径 :点击顶部菜单 Help -> Show Log in Explorer。如果弹出的文件夹路径变成了 D:/JetBrains/IDEA/system/log,说明迁移成功。
  3. 清理 C 盘旧数据 :确认一切正常且无报错后,您可以安全地删除 C 盘原路径下的旧文件夹:
    • C:\Users\<用户名>\AppData\Roaming\JetBrains\IntelliJIdea<版本号>
    • C:\Users\<用户名>\AppData\Local\JetBrains\IntelliJIdea<版本号>

💡 常见问题与进阶建议

  • 启动失败或配置丢失 :首先检查 idea.properties 中的路径分隔符是否误用了 \。如果问题依旧,将 D 盘的新文件夹内容覆盖回 C 盘原路径即可恢复。
  • 更改项目默认存储位置 :除了缓存目录,建议在 IDEA 中点击 File > Settings > Appearance & Behavior > System Settings,将 Default project directory 也修改为非 C 盘路径。
  • 定期维护 :即使迁移到了新位置,缓存仍会随时间膨胀。建议定期使用 File -> Invalidate Caches 清理过期的索引和编译缓存。