JDK必须为17或更高版本，否则Gradle 8.14.4等主流版本将报错；需正确配置JAVA_HOME和Path，避免中文路径、空格，并建议设置GRADLE_USER_HOME防止C盘爆满。
JDK 必须装好，且版本要匹配 Gradle 要求
Gradle 是基于 Java 的构建工具，不装 JDK 就没法运行。2026 年当前主流 Gradle 版本（如 8.14.4）明确要求 JDK 17 或更高版本——不是“建议”，是硬性门槛。用 java -version 查出来是 1.8.0_301 或 11.0.20？直接报错，gradle -v 会提示 Unsupported class file major version 或干脆找不到 java。
常见错误现象：
- 执行
gradle -v报'java' is not recognized as an internal or external command→JAVA_HOME没配或Path漏了%JAVA_HOME%\bin - 报
Could not determine java version from '17.0.1'→ 实际是 Gradle 版本太老（如 6.x），不兼容 JDK 17，得换 Gradle 7.3+（推荐 8.10+） - IDEA 里同步 Gradle 项目失败，提示 “No valid JVM found” → IDEA 自带 JRE 不行，必须在
File | Settings | Build Tools | Gradle里手动指定项目用的JDK路径
GRADLE_USER_HOME 不配也行，但不配容易爆 C 盘
Gradle 默认把所有下载的依赖、插件缓存、wrapper 包全扔进 C:\Users\<username>\.gradle</username>。一个中等 Spring Boot 项目反复构建几次，这个目录轻松突破 5GB。C 盘小的机器几天就告警。
解决办法就是提前设环境变量：
- 新建系统变量
GRADLE_USER_HOME，值设成你希望的路径，比如D:\gradle\.gradle - 确保该路径所在磁盘有至少 20GB 空闲空间（长期项目建议留 50GB+）
- Windows 下变量名别手误写成
GRADEL_HOME或GRADLE_HOMR，Linux/macOS 下注意大小写（GRADLE_USER_HOME全大写）
解压路径不能含中文、空格、特殊字符
Gradle 启动脚本（gradle.bat / gradle）在解析路径时对空格和中文极其敏感。解压到 C:\Program Files\gradle-8.14.4 或 D:\我的工具\gradle，执行 gradle -v 极大概率卡住或报 The filename, directory name, or volume label syntax is incorrect。
正确做法：
- Windows 推荐解压到纯英文短路径，如
C:\gradle或D:\dev\gradle - macOS/Linux 避免用
~/Downloads/gradle-8.14.4（波浪号可能被 shell 展开异常），改用绝对路径如/opt/gradle - 解压后检查
bin目录下是否有gradle（Linux/macOS）和gradle.bat（Windows）两个可执行文件
最易被忽略的一点：Gradle 安装本身不校验 JDK 版本兼容性，它只检查 java 命令是否存在。等你跑 gradle build 卡在 compileJava 阶段、堆栈里全是 UnsupportedClassVersionError，才回头查 JDK——这时候已经浪费半小时以上。务必在解压前，先确认 java -version 输出的主版本号 ≥ Gradle 文档要求的最低版本。
