Gradle命令找不到的根本原因是PATH未包含$GRADLE_HOME/bin；需确保正确设置GRADLE_HOME、在对应shell配置文件（如~/.zshrc或~/.bashrc）中追加PATH、赋予gradle脚本执行权限，并执行source生效。
gradle 命令找不到？PATH 没加对 bin 目录
根本原因不是 Gradle 没装好，而是 PATH 里漏掉了 $GRADLE_HOME/bin —— 系统压根没去那个目录里找 gradle 可执行文件。
常见错误现象：command not found: gradle，但 ls $GRADLE_HOME/bin/gradle 确实存在；或者 gradle -v 报错说“Permission denied”，其实是脚本没执行权限（见下一点）。
- 必须确保
export PATH=$PATH:$GRADLE_HOME/bin这行写在 shell 配置文件末尾，且$GRADLE_HOME已正确定义（比如export GRADLE_HOME=/opt/gradle-8.10） - 别写成
export PATH=$GRADLE_HOME/bin（覆盖原 PATH），否则连ls、cd都会失效 - 改完后一定要运行
source ~/.bashrc（或source ~/.zshrc），仅重启终端不生效 -
gradle脚本需有执行权限：检查ls -l $GRADLE_HOME/bin/gradle，若无x位，手动补上chmod +x $GRADLE_HOME/bin/gradle
该往哪个文件里写 export PATH？看你的 shell 类型
写错配置文件 = 白配。Linux 下不同 shell 加载的初始化文件不同，~/.bashrc 对 Bash 有效，~/.zshrc 对 Zsh 有效，混用就失效。
Linux Security Scanner
下载
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
- 先确认当前 shell：
echo $SHELL，输出是/bin/bash就改~/.bashrc，是/bin/zsh就改~/.zshrc - 不要改
/etc/profile或/etc/environment，除非你真要让所有用户共享这套配置（多数场景不需要，还可能引发权限或冲突问题） - 如果用了 IDE（如 IntelliJ IDEA 或 Android Studio）的终端，它默认继承登录 shell 配置；但 GUI 启动的程序（比如从桌面图标点开的 IDE）可能只读
~/.profile，这时需要把 PATH 行也复制进~/.profile（或让它 source~/.bashrc）
GRADLE_USER_HOME 不设 PATH，但影响构建速度和磁盘空间
GRADLE_USER_HOME 和 PATH 无关，但它决定依赖下载到哪——默认是 ~/.gradle，容易占满家目录，尤其多人共用一台开发机时。
- 建议显式设置：
export GRADLE_USER_HOME=/data/gradle-cache（路径需提前mkdir -p创建） - 这个变量必须在
gradle命令执行前生效，所以也要写进~/.bashrc或~/.zshrc，和PATH在一起更稳妥 - 改完后首次运行
gradle build会重新下载依赖，但后续项目都复用这个缓存，避免重复拉包 - 别设成 NFS 或挂载的网络盘路径，I/O 延迟会导致构建明显变慢
验证 PATH 是否生效？别只信 gradle -v
gradle -v 成功只说明命令能跑，不代表环境变量全局可用。真实构建中常踩的坑是：IDE 或 CI 脚本用的是不同 shell 上下文，PATH 没继承过去。
- 基础检查：
which gradle应输出$GRADLE_HOME/bin/gradle；echo $PATH应包含该路径 - 模拟 CI 场景：
bash -c 'gradle -v'或zsh -c 'gradle -v'，看是否仍成功 - Android Studio 用户额外注意：在 Settings → Build → Build Tools → Gradle 中，勾选 “Use Gradle from wrapper” 是最稳的；若选 “Use Gradle from distribution”，必须确保 IDE 启动时已加载了你的
~/.bashrc（可通过 Help → Edit Custom VM Options 加-Duser.home=/home/you辅助调试）
真正卡住人的从来不是 Gradle 版本或 Java 兼容性，而是 shell 初始化顺序、配置文件作用域、以及 GUI 程序绕过终端环境变量的隐式行为——这些细节不验证，光看 gradle -v 输出绿色文字，很容易误判配置已完成。
