“gradle”不是内部或外部命令，99%是GRADLE_HOME与PATH未配对生效：GRADLE_HOME须指向gradle-X.Y目录（不含bin），PATH须含%GRADLE_HOME%\bin（Windows）或$GRADLE_HOME/bin（macOS/Linux），且需新开终端验证gradle -v。
直接运行 gradle 命令报“不是内部或外部命令”，基本就是环境变量没生效，或者根本没配对路径 —— 不用怀疑，99% 是这个原因。
检查 gradlew 和 gradle 的区别
很多人混淆这两个命令：gradle 调用的是你本地安装的 Gradle（需手动配置环境变量），而 gradlew 是项目自带的 Wrapper 脚本，只在项目根目录下有效，且不依赖系统 PATH。如果你只是想构建当前项目，优先用 gradlew（Windows）或 ./gradlew（macOS/Linux）。
-
gradlew不存在？先确认项目根目录下有gradlew（Linux/macOS）或gradlew.bat（Windows）文件 - 没有？运行
gradle wrapper生成（前提是本地gradle命令能用；如果也不能用，跳到下一步） - Android Studio 终端里报错？别用
gradle，统一改用gradlew—— Studio 默认不继承系统 PATH，即使你配好了也常失效
配置 GRADLE_HOME 和 PATH 的关键路径
Gradle 官方二进制包解压后，bin 目录才含可执行文件；但很多人从 Android Studio 自动下载的缓存目录里找路径，容易出错。正确路径结构是：
C:\Users\{用户名}\.gradle\wrapper\dists\gradle-{X.Y}-all\{哈希串}\gradle-{X.Y}\bin
注意：GRADLE_HOME 应指向 gradle-{X.Y} 目录（不含 \bin），而 PATH 里加的是 %GRADLE_HOME%\bin（Windows）或 $GRADLE_HOME/bin（macOS/Linux）。
- 路径中不能含中文、空格或特殊符号（比如
C:\Program Files\就大概率失败） - 改完环境变量后，必须新开一个终端（cmd/PowerShell/Terminal）验证，旧窗口不会刷新 PATH
- 验证命令用
gradle -v，不是gradle -version（后者不识别）
Android Studio 中 gradle 仍不可用的典型场景
即使系统 cmd 里 gradle -v 成功，在 Android Studio 的 Terminal 里仍可能报错。这不是配置问题，而是 Studio 启动时未加载用户环境变量（尤其 Windows 上用快捷方式启动时）。
- 最稳方案：在 Studio Terminal 里直接切到项目根目录，运行
./gradlew build（macOS/Linux）或gradlew build（Windows） - 若坚持用
gradle，可在 Studio 设置里关掉 “Shell path” 的默认值（Settings → Tools → Terminal → Shell path），改成cmd.exe /k "C:\path\to\your\env\setup.bat"手动加载环境 - 不要依赖 AS 自带的 Gradle 配置页里的 “Use Gradle from wrapper” 开关来解决命令行问题 —— 它只影响构建行为，不修复终端 PATH
真正容易被忽略的点：Gradle Wrapper 的 gradlew 脚本本身依赖 Java，如果 java -version 在终端里都报错，gradlew 也会静默失败 —— 先确保 JDK 环境就绪，再处理 Gradle。
