gradle环境配置核心是两步:设gradle_home指向解压根目录,再将%gradle_home%\bin加入path;且必须前置验证jdk已正确安装并配置java_home,因gradle不自带jvm、完全依赖系统jdk。

gradle -v 报“不是内部或外部命令”,说明环境变量没配对——核心就两步:设 GRADLE_HOME,再把 %GRADLE_HOME%\bin 加进 Path。Java 依赖必须前置验证,否则后续全卡住。
确认 JDK 已就位且 JAVA_HOME 正确
Gradle 不自带 JVM,它完全依赖系统已安装的 JDK(不是 JRE)。没这步,gradle -v 即使路径对了也会静默失败或报错 Could not determine java version。
- 先在命令行运行
java -version,确保输出含javac和版本号(如17.0.3) - 再运行
echo %JAVA_HOME%,确认指向的是 JDK 根目录(如C:\Program Files\Java\jdk-17.0.3),不是...\jre或子目录 - 如果
%JAVA_HOME%\bin没加进Path,java命令本身都可能失效,Gradle 更无从谈起
GRADLE_HOME 必须指向解压后的根目录,不能带 bin 或 lib
下载的是 gradle-8.10.2-bin.zip 或 -all.zip?解压后你会看到 bin/、lib/、init.d/ 等子目录。环境变量值必须是这一层的完整路径。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南,适用于远程桌面访问、安全 RDP 等。
- ✅ 正确示例:
C:\DevTools\gradle-8.10.2(里面直接有bin文件夹) - ❌ 错误写法:
C:\DevTools\gradle-8.10.2\bin(会导致gradle命令找不到启动脚本) - ⚠️ 路径含空格(如
C:\Program Files\...)一般不影响,但若遇到奇怪解析错误,优先换到D:\gradle这类无空格路径
添加 %GRADLE_HOME%\bin 到 Path 后必须新开命令行窗口
Windows 的环境变量是进程级继承的。改完点“确定”只是更新了注册表,已打开的 cmd / PowerShell 不会自动 reload。
- 不要在旧窗口里反复执行
refreshenv或set Path=...—— 这些只改当前会话,不可靠 - 务必关闭所有终端,再打开一个全新的命令提示符,再试
gradle -v - 如果仍报错,用
echo %Path%拉到底,肉眼确认是否真出现了%GRADLE_HOME%\bin对应的实际路径(比如C:\DevTools\gradle-8.10.2\bin)
可选但强烈建议:设置 GRADLE_USER_HOME 避免污染用户目录
默认情况下,Gradle 会在 C:\Users\{用户名}\.gradle 下缓存依赖和构建产物。多人共用一台机器、或 C 盘空间紧张时,这个位置很麻烦。
- 新建一个目录,例如
D:\gradle-repo - 新增系统变量:
GRADLE_USER_HOME=D:\gradle-repo - 该变量必须在
gradle -v成功之后再加,否则首次运行可能仍初始化默认位置 - 加完后首次运行任何
gradle命令(如gradle tasks),会自动在新路径下建wrapper/、daemon/等子目录
gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 是解耦的。全局 gradle 命令只是入口,实际构建仍由 wrapper 下载并调用指定版本。所以配好环境变量后,./gradlew build 依然可能拉新包——这不是配置失败,而是 Gradle 的设计逻辑。










