Gradle Wrapper 和 IDEA 的 Gradle JVM 设置相互独立：Wrapper 决定 Gradle 版本，Gradle JVM 决定运行该 Gradle 的 JDK；二者错配会导致 Unsupported class file major version 等错误；Gradle With Me 1.6.x 插件可自动根据 wrapper 版本切换 IDEA 的 Gradle JVM，但不修改 wrapper 或 org.gradle.java.home。
Gradle Wrapper 和 IDEA 的 Gradle JVM 设置是两回事
很多人以为改了 gradle-wrapper.properties 里的 distributionUrl，IDEA 就会自动跟着用那个版本——其实不会。IDEA 的 Gradle JVM 是独立配置项，它只决定「用哪个 JDK 去运行 Gradle 进程」，而 Wrapper 才真正决定「用哪个 Gradle 版本执行构建逻辑」。两者错配时，常见现象是：Unsupported class file major version、Could not determine java version，或者构建成功但运行时报 NoClassDefFoundError（字节码版本不匹配导致类加载失败）。
- Wrapper 指定 Gradle 8.5 → 它需要 JDK 17+ 运行，但 IDEA 的 Gradle JVM 设为 JDK 8 → 构建直接失败
- Wrapper 是 Gradle 7.2 → 它不支持 JDK 17，但 IDEA 的 Gradle JVM 设为 JDK 17 → 报
Unsupported major.minor version 61 - Wrapper 和 JVM 版本都对，但项目里
org.gradle.java.home没配或配错路径 → 实际编译用的 JDK 和你预期的不一致
检查并强制对齐三处关键配置
必须同时确认以下三点是否协同一致，缺一不可：
-
gradle/wrapper/gradle-wrapper.properties中的distributionUrl（例如gradle-8.5-bin.zip） - IDEA 的 Settings → Build → Gradle → Gradle JVM（必须指向一个该 Gradle 版本能跑起来的 JDK，查官方兼容表：Gradle 8.x 要求 JDK 17–20）
- 项目根目录
gradle.properties中的org.gradle.java.home（可选但推荐显式设置，用于编译和测试阶段的 JDK，值应与 Gradle JVM 同源或至少兼容）
注意：org.gradle.java.home 不影响 Gradle 进程自身启动（那是 Gradle JVM 干的事），但它控制 compileJava、test 等任务实际使用的 JDK。如果这里设成 JDK 8，而 Wrapper 是 Gradle 8.5，构建能过，但编译出的 class 文件是 Java 8 字节码——可能和依赖库不兼容。
Gradle With Me 插件能自动同步哪部分
这个插件（v1.6.x）真正解决的是「IDEA 的 Gradle JVM 设置随项目自动切换」的问题。它读取当前项目的 gradle-wrapper.properties，再结合内置的 Gradle-JDK 兼容映射表，自动把 IDEA 的 Gradle JVM 切到推荐 JDK。但它不会修改 gradle-wrapper.properties，也不会覆盖 org.gradle.java.home。
- 启用后，打开一个用 Gradle 7.6 的老项目，IDEA 的 Gradle JVM 会自动切到 JDK 11
- 切换到 Gradle 8.5 的新项目，JVM 自动切到 JDK 17
- 如果本地没装对应 JDK，插件会提示，但不会帮你下载安装
- 它不处理 AGP（Android Gradle Plugin）版本冲突——那是另一层兼容关系
最容易被忽略的陷阱：wrapper 升级后没清缓存
改完 distributionUrl，你以为就完了？IDEA 可能还在用旧 wrapper 下载的 Gradle 解压目录。它缓存在 $GRADLE_USER_HOME/wrapper/dists/ 下，目录名带 hash，不容易识别。结果就是：你明明改了 8.5，IDEA 却仍在跑 7.6 的二进制。
- 最稳妥做法：删掉整个
$GRADLE_USER_HOME/wrapper/dists/目录（或只删对应版本 hash 子目录） - 然后点 IDEA 的 File → Reload project，让 wrapper 重新下载解压
- 别信右下角“Gradle sync completed”——要进 Gradle 工具窗口 → 右键项目 → Reload project 才算真重载
这个步骤漏掉，90% 的“改了 wrapper 还不生效”问题就出在这儿。
