Gradle在Linux中可通过SDKMAN!、手动解压、APT、YUM/DNF四种方式安装，均需确保JDK已安装且JAVA_HOME配置正确，最后执行gradle -v验证版本及Java环境。

如果您在Linux系统中需要使用Gradle构建工具，但尚未安装或配置成功，则可能是由于缺少Java环境、未正确设置环境变量或安装方式不匹配当前系统。以下是多种可行的安装与配置方法：

一、通过SDKMAN!自动安装

SDKMAN!是一个用于管理多个软件开发工具版本的命令行工具，特别适合快速安装和切换Gradle版本，适用于具备网络访问能力（尤其是可连接境外源）的Linux环境。

1、在终端中执行安装SDKMAN!的初始化命令：
curl -s "https://get.sdkman.io" | bash

2、加载SDKMAN!环境：
source "$HOME/.sdkman/bin/sdkman-init.sh"

3、验证SDKMAN!是否就绪：
sdk version

4、列出可用的Gradle版本：
sdk list gradle

5、选择并安装指定版本（例如8.10）：
sdk install gradle 8.10

6、设置为默认版本：
sdk default gradle 8.10

二、手动下载并解压安装

该方法不依赖外部包管理器，完全可控，适用于内网环境或需精确控制安装路径的场景。要求提前安装JDK并确保JAVA_HOME已正确配置。

1、进入Gradle官方发布页下载对应版本的二进制分发包：
wget https://services.gradle.org/distributions/gradle-8.10-bin.zip

2、创建统一安装目录：
sudo mkdir -p /opt/gradle

3、解压压缩包至该目录：
sudo unzip gradle-8.10-bin.zip -d /opt/gradle/

4、重命名解压后的文件夹便于识别：
sudo mv /opt/gradle/gradle-8.10 /opt/gradle/current

5、编辑全局环境变量配置文件：
sudo nano /etc/profile

6、在文件末尾添加以下两行（注意等号两侧无空格）：
export GRADLE_HOME=/opt/gradle/current
export PATH=$GRADLE_HOME/bin:$PATH

7、使配置立即生效：
source /etc/profile

三、通过APT仓库安装（Ubuntu/Debian系）

该方式利用系统包管理器完成安装，适合偏好标准化部署、追求最小化手动干预的用户，但所含版本可能滞后于官方最新发布。

1、更新系统软件包索引：
sudo apt update

2、安装必要依赖项：
sudo apt install apt-transport-https dirmngr wget software-properties-common -y

3、导入GPG密钥以验证仓库签名：
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys D7CC6F019D06AF36

4、添加第三方Gradle PPA仓库：
sudo add-apt-repository ppa:cwchien/gradle

5、再次更新并安装Gradle：
sudo apt update && sudo apt install gradle -y

四、通过YUM/DNF安装（CentOS/RHEL/Fedora系）

该方法适用于RPM包管理体系，安装过程由系统包管理器统一调度，兼容性高且便于后续维护。

1、启用EPEL扩展仓库（如未启用）：
sudo dnf install epel-release -y

2、安装Gradle（Fedora 36+ 或 RHEL 9+ 推荐使用dnf）：
sudo dnf install gradle -y

3、若使用较老版本CentOS 7，可改用yum并先配置Gradle专用仓库：
sudo yum install java-11-openjdk-devel -y
sudo yum install wget -y
wget https://github.com/gradle/gradle/releases/download/v8.10/gradle-8.10-bin.zip
sudo unzip gradle-8.10-bin.zip -d /opt/

4、配置环境变量：
echo 'export GRADLE_HOME=/opt/gradle-8.10' | sudo tee -a /etc/profile
echo 'export PATH=$GRADLE_HOME/bin:$PATH' | sudo tee -a /etc/profile
source /etc/profile

五、验证安装结果

无论采用上述哪一种安装方式，最终都必须确认Gradle可被系统识别并正常运行，核心是检查其版本输出与Java运行时依赖是否满足。

1、检查Java是否已安装并可达：
java -version

2、执行Gradle版本查询命令：
gradle -v

3、观察输出中Gradle版本号、Kotlin版本、Groovy版本、Ant版本、JVM版本及供应商信息是否完整显示

4、若提示command not found: gradle，请检查PATH是否包含Gradle的bin目录，并确认shell配置文件是否已重新加载

5、若提示Could not determine java version from 'xx.x.x'，说明JAVA_HOME未正确定义或指向了JRE而非JDK