麒麟OS中Gradle安装有三种方法：APT一键安装（适合初学者）、手动下载配置二进制包（适合指定版本）、SDKMAN!多版本管理（适合多项目开发），均需确保JDK已安装并正确配置JAVA_HOME。
如果您在麒麟OS系统中需要使用Gradle构建工具，但尚未完成安装与环境配置，则可能是由于缺少Java运行环境或Gradle二进制包未正确解压并纳入系统路径。以下是针对麒麟OS（基于Linux内核、兼容Ubuntu/Debian系包管理）的多种Gradle安装方法：
一、使用APT包管理器安装（推荐初学者）
麒麟OS默认搭载APT包管理工具，可直接从系统源安装Gradle，省去手动配置环境变量步骤，适合快速启用基础构建能力。
1、打开终端应用程序（可通过“开始菜单 → 系统工具 → 终端”启动）。
2、执行系统更新命令，确保软件源列表为最新：
sudo apt update
3、安装Gradle主程序包：
sudo apt install gradle
4、验证是否安装成功：
gradle -v
若终端输出包含Gradle版本号、Groovy版本、JVM信息及操作系统标识，则表示安装已完成且可立即使用。
二、手动下载并配置二进制包（推荐需指定版本场景）
当项目明确要求特定Gradle版本（如8.4、7.6.1等），或系统源中Gradle版本过旧时，应采用官网二进制包方式安装，该方式可精确控制版本并复用本地Java环境。
1、确认已安装JDK 8或更高版本：
java -version
2、访问Gradle官网下载页面（https://gradle.org/releases/），选择Binary-only分发包（.zip格式），例如gradle-8.4-bin.zip。
3、在终端中创建统一安装目录并进入：
sudo mkdir -p /opt/gradle
cd /opt/gradle
4、使用wget下载对应版本（以8.4为例）：
wget https://services.gradle.org/distributions/gradle-8.4-bin.zip
5、解压压缩包：
sudo unzip gradle-8.4-bin.zip
6、设置GRADLE_HOME环境变量：编辑全局配置文件
sudo nano /etc/environment
7、在文件末尾新增一行：
GRADLE_HOME="/opt/gradle/gradle-8.4"
8、将Gradle的bin目录加入PATH：
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:$GRADLE_HOME/bin"
9、保存并退出nano编辑器（Ctrl+O → Enter → Ctrl+X），然后重新加载环境变量：
source /etc/environment
10、验证安装：
gradle -v
三、通过SDKMAN!多版本管理安装（推荐开发者长期维护多个项目）
SDKMAN!是Linux/macOS平台广泛使用的JVM生态工具链管理器，支持Gradle、Java、Maven等多版本共存与一键切换，特别适合需频繁切换Gradle版本的开发场景。
1、在终端中执行SDKMAN!安装脚本：
curl -s "https://get.sdkman.io" | bash
2、初始化SDKMAN!环境：
source "$HOME/.sdkman/bin/sdkman-init.sh"
3、刷新可用版本列表：
sdk list gradle
4、安装指定版本（例如8.4）：
sdk install gradle 8.4
5、设置默认版本：
sdk default gradle 8.4
6、验证当前激活版本：
gradle -v
此时输出中Gradle版本应与sdk default所设一致，且后续新终端会自动继承该配置。
四、验证与基础测试（所有方法通用）
无论采用哪种安装方式，均需通过最小化构建任务验证Gradle是否真正就绪，避免仅依赖-v输出而忽略实际执行能力。
1、新建测试目录：
mkdir ~/gradle-test && cd ~/gradle-test
2、创建build.gradle文件：
echo "task hello { doLast { println 'Hello from麒麟OS!' } }" > build.gradle
3、执行hello任务（添加-q参数减少冗余日志）：
gradle -q hello
4、终端应准确输出：Hello from麒麟OS!
5、如提示“Could not determine java version from 'xx.x.x'”，说明JAVA_HOME未正确定义，请检查JDK安装路径及/etc/environment中JAVA_HOME变量设置。
