Android Studio/IntelliJ自动设置gradleHome为错误路径问题咨询
错误gradleHome路径的来源
该路径是IDE从历史缓存/遗留配置中读取的,常见来源有三个:
- 项目遗留配置:如果该项目曾在安装了Chocolatey版Gradle 6.8的设备上打开过,对应配置被提交到了版本仓库,你拉取项目后IDE会优先读取旧配置,不会自动替换为你本地的GRADLE_HOME环境变量值。
- IDE全局配置残留:你本地IDE之前曾手动指定过该路径作为默认Gradle安装路径,或是曾通过Chocolatey安装过Gradle 6.8,IDE自动识别后将路径保存到了全局配置中。后续即使卸载对应版本、修改系统环境变量,IDE不会主动同步全局配置,导入项目时会复用旧的路径配置。
- 包装器配置缓存:项目根目录下
gradle/wrapper/gradle-wrapper.properties曾被修改为指向该本地路径,IDE读取后将值缓存到gradle.xml中,后续即使修改了wrapper配置,旧缓存也可能残留。
修复方法
- 关闭IDE后删除项目根目录的
.idea文件夹,重新打开项目让IDE重新生成本地配置即可自动适配你本地的Gradle环境。 - 手动校准全局配置:打开路径
File > Settings > Build, Execution, Deployment > Build Tools > Gradle(Mac端为Android Studio > Settings > Build, Execution, Deployment > Build Tools > Gradle),将Gradle安装路径改为你本地实际路径,或是勾选「Use Gradle from: 'gradle-wrapper.properties' file」让IDE优先使用项目包装器配置。 - 检查项目的
.gitignore规则,确保.idea/gradle.xml、.idea/workspace.xml这类本地私有配置文件被加入忽略列表,避免本地配置被提交到仓库影响其他协作开发者。
内容的提问来源于stack exchange,提问作者birgersp
相关产品推荐
相关产品推荐

