pleaseset 'idea.log.path' property

lt seems you're using 'idea.system.path'property to specify the location of the caches directory

lt seems you're using 'idea.system.path'property to specify the location of the
caches directory. In 2020.1, default locationsof application directories were changed.Forcompatibility, the IDE picked the old locationof logs
(G:\androidcache\.AndroidStudio2025.1.1\system/log), but to avoid any ambiguity in thefuture (and to get rid of this warning) pleaseset 'idea.log.path' property, too.
-Didea.plugins.path=G:\androidcache\.AndroidStudio2025.1.1\plugins

你看到的这条提示信息来自 Android Studio(或 IntelliJ IDEA),它是在提醒你:

虽然你通过 idea.system.path 指定了缓存目录的位置,但 日志目录(logs) 仍然沿用了旧版本的路径。为了明确性和避免未来兼容性问题,请同时设置 idea.log.path 属性


🔍 问题原因

IntelliJ Platform 2020.1 开始,IDE 的默认目录结构发生了变化:

目录类型 旧位置(<2020.1) 新位置(≥2020.1)
Config ~/.AndroidStudioX.Y/config ~/AppData/Roaming/Google/AndroidStudioX.Y (Windows)
System / Caches ~/.AndroidStudioX.Y/system ~/AppData/Local/Google/AndroidStudioX.Y
Logs ~/.AndroidStudioX.Y/system/log ~/AppData/Local/Google/AndroidStudioX.Y/log

你通过启动参数或配置文件设置了:

idea.system.path=G:\androidcache\.AndroidStudio2025.1.1\system

但没有设置日志路径,所以 IDE 自动把日志放在了 system/log 下(旧逻辑),并发出警告。


✅ 解决方案:显式设置 idea.log.path

你需要同时指定日志目录,让结构清晰、符合新规范。

方法一:修改 IDE 的 VM 配置文件(推荐)

  1. 找到 Android Studio 的 studio64.exe.vmoptions 文件(Windows) 通常位于:

    C:\Program Files\Android\Android Studio\bin\studio64.exe.vmoptions
    

    或如果你用的是自定义安装路径,则在对应 bin 目录下。

  2. 在文件末尾添加两行(确保路径存在!):

    -Didea.system.path=G:\androidcache\.AndroidStudio2025.1.1\system
    -Didea.log.path=G:\androidcache\.AndroidStudio2025.1.1\log
    
  3. 保存文件,重启 Android Studio。

💡 建议目录结构:

G:\androidcache\.AndroidStudio2025.1.1\
├── system\
└── log\

方法二:通过环境变量(不常用)

你也可以在系统环境变量中设置(但优先级低于 vmoptions):

IDEA_SYSTEM_PATH=G:\androidcache\.AndroidStudio2025.1.1\system
IDEA_LOG_PATH=G:\androidcache\.AndroidStudio2025.1.1\log

官方推荐使用 .vmoptions 文件


✅ 验证是否生效

启动 Android Studio 后:

  • 查看菜单:Help > Show Log in Explorer 应该打开你指定的 log 目录。
  • 警告信息不再出现。

📝 补充说明

  • idea.system.path:存放缓存、索引、插件等(大文件)
  • idea.log.path:仅存放日志文件(.log
  • 分开管理有助于:
    • 避免 C 盘爆满(你已将缓存移到 G 盘)
    • 清理日志不影响缓存
    • 多版本 Android Studio 共存时不冲突

完成上述配置后,警告就会消失,且你的开发环境更规范、可控。

你看到的提示:

"please set 'idea.plugins.path' property, too."

是 Android Studio(或 IntelliJ IDEA)在你自定义了 idea.system.path 后,进一步建议你显式指定插件目录路径,以确保所有关键目录都明确配置、避免未来兼容性问题。


✅ 为什么需要设置 idea.plugins.path

  • 默认情况下,插件存储在 system/plugins/ 子目录中。

  • 但如果你移动了

    system
    

    目录(如你做的

    G:\androidcache\...
    

    ),IDE 虽然能自动推断插件位置,但

    官方推荐显式声明

    ,以:

    • 避免歧义
    • 支持更灵活的目录布局(比如把插件单独放 SSD)
    • 确保多版本 IDE 共存时互不干扰

🔧 解决方案:在 .vmoptions 中添加插件路径

步骤 1:编辑 VM 配置文件

打开 Android Studio 的 VM 配置文件(Windows):

C:\Program Files\Android\Android Studio\bin\studio64.exe.vmoptions

💡 如果你使用的是 Android Studio Canary / Preview,文件名可能包含版本,如 studio64.exe.preview.vmoptions

步骤 2:添加三行配置(系统 + 日志 + 插件)

-Didea.system.path=G:\androidcache\.AndroidStudio2025.1.1\system
-Didea.log.path=G:\androidcache\.AndroidStudio2025.1.1\log
-Didea.plugins.path=G:\androidcache\.AndroidStudio2025.1.1\plugins

✅ 建议目录结构:

G:\androidcache\.AndroidStudio2025.1.1\
├── system\
├── log\
└── plugins\

步骤 3:创建对应文件夹(重要!)

在资源管理器中手动创建以下空文件夹(如果不存在):

  • G:\androidcache\.AndroidStudio2025.1.1\system
  • G:\androidcache\.AndroidStudio2025.1.1\log
  • G:\androidcache\.AndroidStudio2025.1.1\plugins

⚠️ 如果目录不存在,IDE 可能启动失败或回退到默认路径。

步骤 4:重启 Android Studio

启动后:

  • 安装的插件会存入 plugins 目录
  • 日志写入 log
  • 缓存/索引写入 system
  • 警告将彻底消失 ✅

🔍 如何验证插件路径是否生效?

  1. 打开 Android Studio

  2. 进入 Settings (Preferences) > Plugins

  3. 点击右上角齿轮图标 → "Manage Plugin Directories"

  4. 你会看到类似:

    G:\androidcache\.AndroidStudio2025.1.1\plugins
    

    表示配置成功。

或者查看日志:

  • Help > Show Log in Explorer → 应该打开你的 log 目录
  • 日志文件中会记录插件加载路径

📝 完整 .vmoptions 示例(推荐)

-Xms256m
-Xmx2048m
-XX:ReservedCodeCacheSize=1024m
-Didea.system.path=G:\androidcache\.AndroidStudio2025.1.1\system
-Didea.log.path=G:\androidcache\.AndroidStudio2025.1.1\log
-Didea.plugins.path=G:\androidcache\.AndroidStudio2025.1.1\plugins

💡 提示:不要删除原有的内存参数(如 -Xmx),只追加 -Didea.xxx.path 行。


完成以上配置后,Android Studio 将完全使用你指定的目录,不再依赖默认路径,也不会再弹出任何关于路径的警告。同时,你的 C 盘压力也会大大减轻!