Linux服务器Gradle安装全指南：从零开始配置构建工具

一、准备工作

在开始安装前，请确保您的Linux服务器满足以下基本要求：

• 已安装Java JDK 8或更高版本（推荐OpenJDK）
• 具有sudo权限的用户账户
• 稳定的网络连接
• 至少1GB可用磁盘空间

二、通过包管理器安装（推荐）

2.1 使用SDKMAN工具

对于开发者而言，SDKMAN是最便捷的Gradle安装方式：

# 安装SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 列出可用Gradle版本
sdk list gradle

# 安装指定版本（示例使用7.4.2）
sdk install gradle 7.4.2

2.2 使用系统包管理器

对于Ubuntu/Debian系统：

sudo apt update
sudo apt install gradle

注意：包管理器提供的版本可能不是最新的稳定版。

三、手动安装Gradle

3.1 下载二进制包

访问Gradle官方发布页获取最新版本链接：

# 下载（以7.4.2为例）
wget https://services.gradle.org/distributions/gradle-7.4.2-bin.zip

# 解压到/opt目录
sudo unzip -d /opt gradle-7.4.2-bin.zip

# 创建符号链接
sudo ln -s /opt/gradle-7.4.2 /opt/gradle

3.2 配置环境变量

编辑~/.bashrc或/etc/profile文件：

export GRADLE_HOME=/opt/gradle
export PATH=$PATH:$GRADLE_HOME/bin

然后执行source ~/.bashrc使配置生效。

四、验证安装

执行以下命令验证安装是否成功：

gradle -v

正确输出应包含Gradle版本、Groovy版本和JVM信息。

五、进阶配置

5.1 配置Gradle守护进程

在~/.gradle/gradle.properties中添加：

org.gradle.daemon=true
org.gradle.parallel=true

5.2 配置镜像加速

对于国内服务器，可配置阿里云镜像：

repositories {
    maven { url 'https://maven.aliyun.com/repository/public/' }
    mavenCentral()
}

六、常见问题解决

• 权限不足错误：确保对/opt目录有写入权限，或使用sudo
• 命令未找到：检查PATH环境变量是否包含Gradle bin目录
• 版本冲突：使用sdkman管理多版本，通过sdk use gradle 版本号切换

七、最佳实践建议

1. 生产环境建议使用稳定版而非最新版
2. 考虑使用Docker容器化Gradle环境
3. 定期清理~/.gradle/caches目录
4. 为CI/CD系统配置专门的Gradle用户