必须手动安装Gradle 7.5并配置系统级环境变量,下载gradle-7.5-all.zip解压至/opt/gradle/gradle,再通过编辑/etc/profile设置GRADLE_HOME、PATH和GRADLE_USER_HOME,最后source生效并用gradle -v验证。

如果您在统信UOS系统中需要构建Java或Android项目,但终端提示gradle: command not found,则说明Gradle尚未安装或环境变量未正确配置。必须手动安装Gradle 7.5并配置系统级环境变量,APT安装版本过旧,不推荐用于Android项目。
下载并解压Gradle二进制包
Gradle官方提供预编译的All Distribution压缩包,包含全部文档与示例,适用于离线环境与完整开发需求。必须使用Linux兼容的.tar.gz或.zip格式,不可使用Windows专用安装器。
打开终端,创建统一安装目录:sudo mkdir -p /opt/gradle
进入该目录:cd /opt/gradle
下载Gradle 7.5完整版(稳定兼容UOS及Android Gradle Plugin 7.x–8.x):sudo wget https://downloads.gradle-dn.com/distributions/gradle-7.5-all.zip
解压并重命名为gradle:sudo unzip gradle-7.5-all.zip && sudo mv gradle-7.5-all gradle
配置系统级环境变量
为所有用户(包括后续新建用户)启用Gradle命令,需修改全局shell配置文件。UOS默认使用bash,且推荐采用系统级配置以避免普通用户手动重复设置。
第一步:编辑全局profile文件:sudo vim /etc/profile
第二步:在文件末尾追加以下三行(注意路径与权限一致性):
export GRADLE_HOME=/opt/gradle/gradle
export PATH=$PATH:$GRADLE_HOME/bin
export GRADLE_USER_HOME=/opt/gradle/.gradle
【必须确保三行都写在同一段落内,且无空行、无多余空格,否则source后仍无法识别gradle命令】
第三步:使配置立即生效:source /etc/profile
验证安装结果
环境变量生效后,终端可直接调用gradle命令;版本输出将确认JVM兼容性、Gradle内核版本及Groovy运行时信息,是判断安装成功的唯一权威依据。
执行版本检查:gradle -v
确认输出中包含以下关键字段:Gradle 7.5、Kotlin: 1.6.10、Groovy: 3.0.10、JVM: 11.0.21 (Ubuntu)


















