gradle -v 能跑通才算真正装好；需确保JDK 17/21已正确配置、Gradle解压路径纯英文无空格、GRADLE_HOME与Path设置准确且新开命令行验证。
gradle -v能跑通，才算真正装好。Windows 上装 Gradle 不是解压完加个环境变量就完事——JDK 版本不匹配、路径含中文、缓存占满 C 盘、命令行没刷新，任何一个都可能让你卡在「不是内部或外部命令」。
确认 JDK 已就绪且版本兼容
Gradle 不自带 JVM，它依赖系统已安装的 JDK。2026 年主流项目（如 Spring Boot 3.3+、Android Gradle Plugin 8.7+）要求 JDK 17 或 JDK 21，JDK 8 和 JDK 11 已无法运行多数新插件。
- 在 CMD 或 PowerShell 中执行
java -version，输出必须是17.0.x、21.0.x这类 LTS 版本 - 若提示「'java' 不是内部或外部命令」，说明
JAVA_HOME没配，或未加入Path—— 先解决这个，否则 Gradle 必然失败 - 不要用 JRE，必须是完整 JDK（含
javac）
下载二进制包并解压到纯英文无空格路径
官网 https://gradle.org/releases/ 下载页面只认 bin.zip（不是 all.zip，后者体积大、没必要，且 Windows 下容易因解压工具问题损坏）。
- 解压目标路径只能含英文、数字、下划线，例如
D:\tools\gradle-8.14.2；避免C:\Program Files\（空格和权限）、D:\我的软件\（中文） - 解压后检查目录结构：根目录下必须有
bin、lib、init.d等文件夹，缺任何一项说明解压不完整 - 别直接双击 ZIP 用资源管理器“提取到当前文件夹”——它有时会多套一层文件夹，导致
%GRADLE_HOME%\bin实际指向错误
配置 GRADLE_HOME 和 Path，且必须新开命令行验证
环境变量改完不会自动生效到已打开的 CMD/PowerShell 窗口，这是最常被忽略的一步。
- 新建系统变量：
GRADLE_HOME=D:\tools\gradle-8.14.2（注意：不带\bin） - 编辑
Path，新增一行：%GRADLE_HOME%\bin（不要手敲路径，用变量引用；结尾勿加分号） - 关闭所有已有终端，**重新打开一个 CMD**，再执行
gradle -v - 如果仍报错，用
echo %GRADLE_HOME%确认变量值是否正确读取；用where gradle查看系统找到的是哪个可执行文件
可选但强烈建议：设置 GRADLE_USER_HOME 到非系统盘
默认缓存放在 C:\Users\，长期构建 Android 或多模块项目后，这个目录轻松突破 10GB，C 盘告急是常态。
- 新建系统变量：
GRADLE_USER_HOME=D:\.gradle（路径可自定义，但同样要求纯英文、无空格） - 该变量需在
gradle -v成功后再设，否则首次运行可能已在 C 盘生成部分缓存 - 设完后首次执行
gradle build会重新下载 wrapper 和插件，属于正常现象；后续所有项目都会复用该目录
真正麻烦的从来不是「怎么装」，而是「为什么装好了却跑不起来」——90% 的问题出在 JDK 版本、路径字符、环境变量未刷新这三处。装完别急着建项目，先确保 gradle -v 和 gradle --version 都能秒出结果，再往下走。
