必须确保Gradle版本与Android Gradle Plugin（AGP）严格匹配，否则同步失败、构建卡死或报错“Unsupported Gradle version”将直接阻断后续所有操作；需下载Binary-only版、解压至无空格中文路径、正确配置GRADLE_HOME和Path环境变量、重启终端验证gradle -v，并优先使用项目内gradlew.bat调用Wrapper指定版本。
要在Windows系统上安装Gradle构建工具以编译Android项目，必须确保Gradle版本与Android Gradle Plugin（AGP）严格匹配，否则同步失败、构建卡死或报错“Unsupported Gradle version”将直接阻断后续所有操作。
下载并解压Gradle二进制包
访问Gradle官方发布页，选择与你Android Studio中AGP版本兼容的Gradle版本（例如AGP 8.4对应Gradle 8.6）。务必点击“Binary-only”链接下载.zip文件，不要选“Complete”或“Source”版本。
将压缩包解压到不含空格和中文的路径，如C:\gradle\gradle-8.6。若解压到C:\Program Files\gradle或D:\我的工具\gradle，后续执行gradlew时会因路径解析失败而报错“Could not determine java version from 'xx'”。
配置系统级环境变量
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
在“系统变量”区域点击“新建”，创建变量名GRADLE_HOME，变量值填入你解压的完整路径，例如C:\gradle\gradle-8.6。
在“系统变量”中找到Path，点击“编辑”→“新建”，添加%GRADLE_HOME%\bin。这一步漏掉或写成%GRADLE_HOME%/bin（斜杠方向错误）会导致命令行无法识别gradle命令。
【注意：修改完环境变量后，必须关闭并重新打开所有已打开的命令提示符或PowerShell窗口，否则gradle -v仍会提示“不是内部或外部命令”】
验证安装并关联Android项目
打开新的CMD或PowerShell窗口，执行：
gradle -v
成功时将显示Gradle版本、JVM版本、Groovy版本等信息；若报错，请回溯检查GRADLE_HOME路径是否拼写错误、Path中是否遗漏%GRADLE_HOME%\bin、当前终端是否为修改环境变量后新启动的实例。
进入你的Android项目根目录（含gradlew.bat），运行：
gradlew assembleDebug
该命令会自动调用项目内封装的Gradle Wrapper（gradlew.bat），优先使用gradle/wrapper/gradle-wrapper.properties中声明的Gradle版本。即使你本地已装Gradle 8.6，只要配置文件指定的是7.5，Wrapper就会下载并使用7.5——这是Android项目的标准行为，无需手动切换本地Gradle版本。
