如何设置GRADLE_LOCAL_JAVA_HOME？自定义Android Studio默认Gradle JDK

每次打开现有Android项目时，Android Studio默认会将Gradle JDK绑定到内置JetBrains Runtime对应的GRADLE_LOCAL_JAVA_HOME，需要手动切换到与JAVA_HOME、PATH配置一致的自定义JDK，以下是几种可行的解决方案：

一、全局Gradle配置（所有项目生效） #

官方说明GRADLE_LOCAL_JAVA_HOME会读取.gradle/config.properties中的java.home属性，全局的$HOME/.gradle/config.properties是生效的，之前配置无效大概率是路径错误或缓存问题：

1. 若$HOME/.gradle/config.properties不存在，手动创建该文件
2. 在文件中写入自定义JDK的绝对路径，示例：
   • Windows系统：java.home=C:\Program Files\Java\jdk-17.0.10
   • Linux/macOS系统：java.home=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
3. 保存文件后，重启Android Studio并重新打开项目；若仍不生效，执行「File → Invalidate Caches... → Invalidate and Restart」清除缓存

二、Android Studio全局默认JDK设置 #

通过IDE全局设置指定默认Gradle JDK，新创建项目和现有项目修改后都会记住配置：

1. 打开Android Studio，进入「File → New Projects Setup → Structure for New Projects」（旧版本为「File → Other Settings → Default Project Structure」）
2. 在「SDK Location」面板中找到「Gradle JDK」，选择你的自定义JDK路径并保存
3. 对于现有项目，进入「File → Project Structure → SDK Location → Gradle JDK」选择自定义JDK，同步项目后下次打开会自动沿用该设置

三、项目级Gradle配置（单个项目生效） #

如果仅需要特定项目使用自定义JDK，在项目根目录的gradle.properties文件中添加：

org.gradle.java.home=/path/to/your/custom/jdk

该配置优先级高于全局Gradle配置，会单独覆盖当前项目的JDK设置

常见配置无效原因 #

• 自定义JDK路径填写错误：必须使用绝对路径，注意路径中的空格或特殊字符（Windows下可直接写带空格的路径，无需转义）
• Android Studio缓存未更新：清除缓存并重启IDE即可
• 全局config.properties权限不足：确保文件有读写权限

内容的提问来源于stack exchange，提问作者Andrzej Zabost