根本原因是zsh未找到gradle可执行文件，即未安装、PATH未包含其bin路径，或zsh未加载配置；需先用which gradle验证存在性，再检查~/.zshrc中是否正确定义GRADLE_HOME并导出$GRADLE_HOME/bin到PATH，避免混用.bash_profile，最后source ~/.zshrc或exec zsh生效。
Gradle 在 zsh 中报 command not found，根本原因是 shell 找不到 gradle 可执行文件——它要么没装，要么装了但路径没加进 PATH，要么加了但 zsh 没加载到。
确认 gradle 是否真的存在
别急着改配置，先验证它是不是“有但看不见”：
- 运行
which gradle或command -v gradle：如果返回空，说明当前 shell 环境里确实没注册这个命令 - 检查你项目目录下有没有
./gradlew：有就说明 Gradle 是项目级封装的，不是全局安装的；直接用./gradlew build即可，不用配全局gradle - 如果你用 Android Studio，
gradle很可能藏在~/.gradle/wrapper/dists/下某个子目录里（比如gradle-8.4-bin/xxx/gradle-8.4），而不是独立安装的
手动添加 GRADLE_HOME 到 PATH（最常用场景）
多数人遇到这问题，是因为从 Android Studio 自动下载的 Gradle 二进制没暴露给 shell。你需要显式导出路径：
Twitter Command Center Search Post Interact
下载
通过 AIsa 搜索 X/Twitter 的个人资料、推文、趋势并进行 OAuth 授权发布，适用于需要 Twitter 研究、监控或互动工作流的场景。
- 先确定你的实际路径，例如：
/Users/yourname/.gradle/wrapper/dists/gradle-8.4-bin/abc123xyz/gradle-8.4（用ls -d ~/.gradle/wrapper/dists/*/bin/gradle快速找） - 编辑
~/.zshrc：echo 'export GRADLE_HOME=/path/to/your/gradle-8.4' >> ~/.zshrc - 再追加 bin 目录到
PATH：echo 'export PATH=$PATH:$GRADLE_HOME/bin' >> ~/.zshrc - 重载配置：
source ~/.zshrc；或者新开终端 - 注意：
GRADLE_HOME必须指向含bin/gradle的那个目录，不是 wrapper/dists 的父目录
避免混用 .bash_profile 和 .zshrc
Mac 默认用 zsh，但很多人沿用旧习惯往 ~/.bash_profile 里写环境变量，结果 zsh 根本不读它：
- 检查
~/.zshrc里有没有source ~/.bash_profile—— 没有就别指望 bash 配置生效 - 更稳妥的做法是：把所有
export和PATH相关内容，直接复制进~/.zshrc末尾，不要依赖间接引用 - 如果同时用了 Homebrew 安装的
gradle（brew install gradle），它的路径通常是/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），确保这个路径也在PATH里且靠前 - 运行
echo $PATH看输出里是否真包含你加的路径；顺序很重要，重复路径或错误拼写（比如多空格、少$）都会让整条失效
VSCode 终端或新标签页不生效？重载环境要彻底
VSCode 启动时会读一次 shell 配置，但不会自动 reload；新终端标签页也可能缓存旧环境：
- 在 VSCode 中，关掉所有终端，然后用
Cmd+Shift+P→ “Shell Command: Install 'code' command in PATH”，再重启 VSCode - 或者，在 VSCode 终端里手动运行
source ~/.zshrc（仅本次生效） - 真正一劳永逸：改完
~/.zshrc后，执行exec zsh，它会用新配置完全替换当前 shell 进程 - 别忽略隐藏字符：用
cat -A ~/.zshrc查看是否有 ^M（Windows 换行符）导致语法错误
最常被跳过的细节是：Gradle wrapper（gradlew）和全局 gradle 是两套东西，前者不需要任何环境配置，后者必须精确指定 GRADLE_HOME 路径且不能错一级目录。配错一次，gradle -v 就永远静默失败。
