结论：不要设GRADLE_HOME和PATH中的gradle/bin，应禁用全局Gradle绑定；只配置GRADLE_USER_HOME统一缓存目录，强制IDEA使用Wrapper，并确保“Use Gradle from wrapper”已勾选，让每个项目自主管理Gradle版本。
Gradle多版本共存时怎么配置环境变量
直接说结论：不要用GRADLE_HOME + PATH全局绑定单一版本。这种做法在多项目、多Gradle版本场景下是根本性错误，会导致 IDEA 同步失败、./gradlew 和命令行 gradle 行为不一致、守护进程混乱。
真正该做的，是让每个项目自己管自己的 Gradle 版本，只把 wrapper 当作唯一可信入口，环境变量只起辅助作用。
为什么不能设GRADLE_HOME
IDEA 会优先读取 GRADLE_HOME（如果存在），然后忽略项目里的 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl。结果就是：你打开 JDK8+Gradle6.8 的老项目，IDEA 却硬要用你本地 GRADLE_HOME 指向的 Gradle 8.10 去解析 build.gradle —— 报错是必然的。
更糟的是，gradle 命令行也会受其影响，和 ./gradlew 行为割裂，调试时极易误判。
推荐的环境变量配置方式
只做三件事，且全部为可选（即不设也不影响 wrapper 正常工作）：
-
GRADLE_USER_HOME：指向一个统一的 Gradle 缓存目录，比如D:\gradle\home（Windows）或~/.gradle（Linux/macOS）。避免多个 Gradle 版本各自下载一遍依赖，节省磁盘和带宽。 -
ORG_GRADLE_PROJECT_javaHome（可选）：用于强制指定某个项目构建时的 JDK 路径，仅在 wrapper 自动探测失败时临时覆盖，不要设成全局。 - 不设
GRADLE_HOME，也不往PATH里加任何gradle/bin路径。
验证是否生效：在终端执行 echo %GRADLE_USER_HOME%（Windows）或 echo $GRADLE_USER_HOME（macOS/Linux），确认输出是你期望的路径即可。
Windows 下如何永久设置GRADLE_USER_HOME
别去改系统级 PATH，那是给命令行 gradle 用的，而你根本不该用它。正确做法是用户级环境变量：
- 按
Win + S搜索 “环境变量” - 点击 “编辑系统环境变量” → “环境变量” 按钮
- 在 “用户变量” 区域点击 “新建”
- 变量名填
GRADLE_USER_HOME，变量值填你想要的绝对路径（如D:\gradle\home） - 确保路径中不含空格、中文，且目录已手动创建
注意：改完后必须重启 IDEA 和所有终端窗口，否则新变量不生效。Android Studio 同理，且要额外检查 File > Settings > Build > Build Tools > Gradle 里是否勾选了 “Use Gradle from wrapper” —— 这才是关键开关。
最常被忽略的一点：Gradle 多版本共存本身不依赖环境变量，wrapper 才是事实标准。环境变量只是帮你省空间、少下载、防冲突的“润滑剂”，不是“启动器”。一旦你开始靠 gradle -v 来验证项目是否能跑，就已经走偏了。
