Android Studio 无法识别全局gradle.properties文件如何处理？

步骤1：确认AS内部的Gradle用户目录配置 #

• 打开Android Studio，依次进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 查看页面中的「Gradle user home」配置项，该路径才是AS实际读取全局Gradle配置的目录，优先级高于系统环境变量
• 若路径和你存放gradle.properties的C:\Users\你的用户名\.gradle不一致，直接修改为对应路径，点击「应用」后重启AS

步骤2：排查全局gradle.properties文件问题 #

• 先确认文件后缀正确：打开Windows资源管理器顶部「查看」标签，勾选「文件扩展名」，检查文件是否确实是gradle.properties，而非被自动加了.txt后缀的gradle.properties.txt
• 检查文件权限：右键文件选择「属性 > 安全」，确认当前Windows登录用户对该文件拥有「读取」权限，缺失的话手动添加对应权限
• 检查文件内容格式：所有键值对严格遵循key=value格式，注释必须以#开头单独占行，不要在配置行中插入中文注释或多余空格

步骤3：强制刷新项目配置 #

• 重启AS后打开对应项目，点击右侧边栏的Gradle面板，点击左上角的「Reload All Gradle Projects」按钮重新同步配置
• 若仍未生效，依次点击File > Invalidate Caches...，勾选「Clear file system cache and local history」，点击「Invalidate and Restart」，等待AS重启完成后再同步项目

版本兼容临时方案 #

Arctic Fox（2020.3.1）版本存在已知的全局Gradle配置读取优先级bug，若以上步骤都尝试后依旧不生效，可以在项目级gradle.properties的顶部添加如下代码，手动引入全局配置：

apply from: file("${System.getProperty('user.home')}/.gradle/gradle.properties")

升级到更高版本的Android Studio即可修复该底层bug，无需再手动引入。

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