必须先安装JDK 17或21并正确配置JAVA_HOME和Path，再下载Gradle二进制包解压至纯英文路径，设置GRADLE_HOME与%GRADLE_HOME%\bin到Path，重启CMD后运行gradle -v验证；可选配置阿里云镜像和非系统盘缓存路径。
要在Windows上运行Gradle项目或执行gradle build等命令，必须让系统识别gradle命令，这需要JDK已就绪、Gradle解压路径合规、环境变量设置准确，并在全新命令行中验证通过。
确认JDK版本并修复基础依赖
Gradle不自带JVM，必须依赖系统已安装的JDK。2026年主流项目（如Spring Boot 3.4、Android Gradle Plugin 8.8）强制要求JDK 17或JDK 21——JDK 8/11已无法启动多数新插件。
打开CMD，执行java -version，输出必须是17.0.x或21.0.x这类LTS版本号；若提示“'java' 不是内部或外部命令”，说明JAVA_HOME未配置或未加入Path，必须先解决此问题，否则Gradle必然失败。
注意：必须使用完整JDK（含javac.exe），不能用仅含JRE的运行时环境。
下载并安全解压Gradle二进制包
访问https://www.php.cn/link/a0318d32cb96f76323313e33d189b3ce，只下载Binary-only版本（如gradle-8.14.2-bin.zip），不要选all.zip——它体积大、Windows下易因解压工具损坏且完全没必要。
解压目标路径只能含英文、数字、下划线，例如D:\tools\gradle-8.14.2；严禁使用C:\Program Files\（含空格+管理员权限限制）或D:\我的软件\（含中文）。
解压后检查根目录是否直接包含bin、lib、init.d等文件夹；若多出一层gradle-8.14.2子目录（常见于资源管理器“提取到当前文件夹”操作），说明解压不完整，需重新解压并勾选“使用文件夹名称创建目标文件夹”选项。
配置GRADLE_HOME与Path环境变量
第一步：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
第二步：在“系统变量”区域点击“新建”，变量名填GRADLE_HOME，变量值填你解压后的完整根路径（不带\bin），例如D:\tools\gradle-8.14.2。
第三步：在“系统变量”中找到Path，点击“编辑”→“新建”，输入%GRADLE_HOME%\bin（务必用变量引用，不要手敲路径；结尾勿加分号）。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案，可稳定把窗口收进托盘且不闪控制台。
第四步：关闭所有已打开的CMD/PowerShell窗口，重新打开一个全新的CMD——这是最常被忽略的一步，环境变量修改不会自动生效到已有终端。
第五步：在新CMD中执行gradle -v；若仍报错，先运行echo %GRADLE_HOME%确认变量读取正确，再运行where gradle查看系统实际调用的是哪个可执行文件。
可选：迁移Gradle缓存到非系统盘
方法一：新建系统变量GRADLE_USER_HOME，值设为纯英文无空格路径（如D:\.gradle）。该变量必须在gradle -v成功后再设置，否则首次运行已在C盘生成部分缓存，迁移不彻底。
方法二：不设环境变量，改用命令行参数临时指定——每次构建时加--gradle-user-home D:\.gradle，适合测试场景。
注意：默认缓存位于C:\Users\，长期构建Android或多模块项目后极易突破10GB，C盘告急是常态。
可选：配置阿里云Maven镜像加速依赖下载
进入Gradle解压目录下的init.d文件夹，新建文本文件，重命名为aliyun.gradle（扩展名必须是.gradle，不是.txt）。
用记事本打开该文件，粘贴以下内容并保存：
allprojects { repositories { mavenLocal() maven { url 'https://maven.aliyun.com/repository/public/' } mavenCentral() } }
这一步无需重启CMD，下次执行任何gradle命令（如gradle build）时会自动加载该初始化脚本，后续依赖将优先从阿里云拉取。
