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 安全审计工具,检查 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 -v 输出绿色文字,很容易误判配置已完成。

















