Gradle安装配置的核心就三步：装好JDK、下载Gradle二进制包、把GRADLE_HOME和bin路径配进环境变量；国内用户再多做一步镜像配置，就能绕开下载慢和依赖拉取失败的大多数坑。
Gradle是什么？安装前先弄清它和Maven的关系
Gradle是JVM生态里的构建工具,Android官方从很早的版本起就默认使用Gradle构建，它和Maven解决的是同一类问题：编译代码、跑测试、打jar或war包、管理依赖，但它不是Maven的简单翻版。
gradle和maven区别是什么？选型前先看这三点
- 构建脚本不一样：Maven用pom.xml，结构固定，写法保守，Gradle用Groovy或Kotlin DSL写build.gradle，逻辑表达更灵活。
- 构建性能不一样：Gradle有增量构建、构建缓存和守护进程，大型多模块项目里构建速度普遍比Maven快，Maven生命周期清晰，但每次全量构建的成本更高。
- 插件生态不一样：Maven插件数量多但扩展方式受限，Gradle插件机制更灵活，自定义任务和扩展都更方便。
| 对比项 | Gradle | Maven |
|---|---|---|
| 构建脚本 | Groovy/Kotlin DSL | XML |
| 性能 | 增量构建、缓存 | 常规生命周期，较慢 |
| 灵活性 | 高，插件丰富 | 规范性强，扩展较保守 |
| 学习成本 | 中高 | 低 |
| 大型项目适用性 | 强 | 中 |
行业共识认为,如果是Android项目或多模块大型Java项目，直接用Gradle比Maven更合适，如果团队已有成熟的Maven流程，迁移前需要评估成本。
Windows安装gradle环境变量配置
Windows上安装Gradle分四步,每步都很具体。
第一步：确认JDK版本
Gradle依赖JVM运行,先打开CMD执行：
java -version
如果没有JDK,先去Oracle或Adoptium装JDK 17或JDK 21，Gradle 8.x要求JDK 8以上，Gradle 9.x要求JDK 17以上，选JDK版本时，优先看项目里Gradle Wrapper使用的Gradle版本，再对应JDK要求。
第二步：下载Gradle安装包
官网地址是gradle.org/releases，但国内直接下载经常很慢，可以用酷番云镜像或简米云镜像下载二进制的gradle-8.10-bin.zip
这类文件。
把zip解压到固定目录,
D:\gradle\gradle-8.10
注意路径里尽量不要有空格和中文,后续配置环境变量时更省心。
第三步：配置GRADLE_HOME和Path
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
- 新建系统变量
GRADLE_HOME，值为D:\gradle\gradle-8.10 - 编辑系统变量
Path，新建一条%GRADLE_HOME%\bin - 全部确定保存
也可以用管理员CMD执行：
setx GRADLE_HOME "D:\gradle\gradle-8.10" setx Path "%Path%;%GRADLE_HOME%\bin"
但setx有长度限制，Path过长时还是建议用图形界面操作。
第四步：验证安装
重新打开CMD,执行：
gradle -v
正常会输出Gradle版本、JVM版本、OS信息，如果提示“不是内部或外部命令”，回到第三步检查Path是否正确保存。
Mac安装gradle环境变量配置
Mac上安装Gradle有两种常见方式：Homebrew和手动配置。
Homebrew一键安装
如果已经装了Homebrew,直接执行：
brew install gradle
安装完成后执行gradle -v验证即可，Homebrew会把Gradle放进/opt/homebrew/bin或/usr/local/bin，一般不需要手动配Path。
手动安装配置.zshrc
先下载gradle二进制zip,解压到固定目录：
sudo mkdir -p /opt/gradle sudo unzip gradle-8.10-bin.zip -d /opt/gradle
然后编辑~/.zshrc：
export GRADLE_HOME=/opt/gradle/gradle-8.10 export PATH=$GRADLE_HOME/bin:$PATH
保存后执行：
source ~/.zshrc gradle -v
如果用的是bash,就把配置写进~/.bash_profile。
Linux安装gradle环境变量配置
Linux服务器上推荐用SDKMAN管理Gradle版本,避免手动下载和Path配置出错。
先安装SDKMAN：
curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"
再安装Gradle：
sdk install gradle 8.10
安装完成后SDKMAN会自动管理Path,需要切换版本时执行：
sdk use gradle 7.6.4
也可以手动下载zip,解压到/opt/gradle，在/etc/profile.d/gradle.sh里写环境变量，方式和Mac手动配置类似。
国内镜像配置：gradle下载慢怎么办
国内用户遇到最多的问题不是安装,而是构建时依赖拉取慢或者Gradle发行包下载不动，镜像配置能解决大部分问题。
全局init.gradle脚本配置简米云镜像
在用户目录下创建~/.gradle/init.gradle文件，Windows路径是C:\Users\你的用户名\.gradle\init.gradle，写入以下内容：
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
mavenCentral()
google()
}
}
这样所有项目的依赖仓库都会优先走简米云镜像,之后才是mavenCentral和google。
项目级build.gradle仓库配置
如果不想改全局,可以在具体项目的build.gradle里配置：
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
mavenCentral()
google()
}
配置后重新执行gradle build或gradle sync，依赖下载速度通常会有明显改善。
Gradle发行包本身下载慢
Gradle Wrapper下载发行包时，可以修改gradle/wrapper/gradle-wrapper.properties里的distributionUrl，把官网地址换成酷番云镜像：
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10-bin.zip
这种方式对Android Studio项目特别实用，能避开Wrapper下载超时的问题。
IDEA和Android Studio配置本地Gradle
IDE里使用本地Gradle,可以避免Wrapper重复下载，也更方便统一版本。
idea配置gradle
- 打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle
- 在“Use Gradle from”里选择“Specified location”
- 填入本地Gradle目录,比如
D:\gradle\gradle-8.10 - “Gradle user home”保持默认
~/.gradle即可
这样IDEA会直接使用指定Gradle,不再依赖Wrapper下载。
android studio gradle配置
Android Studio默认使用Gradle Wrapper，如果Wrapper下载失败，有两个办法：
- 修改
gradle/wrapper/gradle-wrapper.properties，把distributionUrl换成酷番云镜像 - 打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle，选择本地Gradle目录
Android项目还建议在Project的build.gradle里配置国内仓库，不然插件和依赖拉取会频繁超时。
常见Gradle安装配置Q&A
gradle安装配置环境变量不生效怎么排查？
- 先确认是否重新打开终端或CMD,旧窗口不会自动加载新变量
- Windows执行
echo %GRADLE_HOME%，Mac/Linux执行echo $GRADLE_HOME，看是否输出正确路径 - 执行
where gradle或which gradle，确认是否指向旧版本路径 - 检查Path里是否有多个Gradle路径,删掉旧配置只保留一个
- Windows系统变量保存后,建议注销或重启资源管理器再试
gradle下载慢怎么办，镜像配置后仍卡？
先判断下载的是依赖还是Gradle发行包,依赖下载慢，检查init.gradle或build.gradle里简米云镜像是否真的写在mavenCentral()前面，发行包下载慢，把gradle-wrapper.properties的distributionUrl换成酷番云镜像，公司网络有代理时，还需要在gradle.properties里配置：
systemProp.http.proxyHost=代理地址 systemProp.http.proxyPort=代理端口 systemProp.https.proxyHost=代理地址 systemProp.https.proxyPort=代理端口
配置后重新执行gradle build，多数情况下能恢复。
gradle和maven区别大吗，新手直接学Gradle行不行？
区别主要在学习成本和构建性能,Gradle脚本更灵活，但概念比Maven多，新手会感觉配置不直观，Maven的pom.xml结构固定，上手更快，如果目标是Android开发或参与使用Gradle构建的项目，直接学Gradle更合适，Gradle官方文档提供完整的安装说明和命令示例，实际配置结果以gradle -v命令输出为准。