Gradle环境搭建：安装配置全攻略

想要高效构建 Java、Kotlin 或 Android 项目？首先需要搭建好 Gradle 环境。本教程将详细指导你如何在 Windows、macOS 和 Linux 系统上安装和配置 Gradle。第一步，确认已安装兼容的 JDK 版本，Gradle 依赖 JVM 运行，不同 Gradle 版本对 JDK 有特定要求。接下来，从 Gradle 官网下载 Binary-only 版本，解压到指定目录，并配置 GRADLE_HOME 环境变量和 PATH 环境变量，以便在命令行中直接使用 gradle 命令。最后，通过运行 `gradle -v` 命令验证安装是否成功。本文还介绍了可选的全局属性配置，以及如何使用 Gradle 初始化项目进行测试，助你快速入门 Gradle 构建。

先确认已安装兼容的JDK版本，再下载解压Gradle并配置GRADLE_HOME和PATH环境变量，最后通过gradle -v验证安装成功。

搭建 Gradle 环境并不复杂，只要按照步骤正确安装和配置环境变量即可。以下是详细的 Gradle 安装与配置步骤，适用于 Windows、macOS 和 Linux 系统。

1. 检查 Java 环境

Gradle 是基于 JVM 的构建工具，因此必须先安装 JDK。Gradle 要求 JDK 版本与所用 Gradle 版本兼容（例如 Gradle 8.x 需要 JDK 17 或更高版本）。

打开终端或命令提示符，输入以下命令检查是否已安装 JDK：

java -version
javac -version

如果未安装，请先下载并安装合适版本的 JDK（推荐使用 Oracle JDK 或 OpenJDK），并配置 JAVA_HOME 环境变量。

2. 下载 Gradle

访问 https://gradle.org/releases/ 下载所需版本的 Gradle。

• 选择“Binary-only”版本（通常足够使用）
• 下载 .zip 文件（Windows）或 .zip/.tgz（macOS/Linux）

也可以使用包管理器安装（可选）：

• macOS（Homebrew）：brew install gradle
• Linux（SDKMAN）：sdk install gradle

3. 解压并安装 Gradle

将下载的压缩包解压到一个固定目录，例如：

• Windows: C:\gradle\gradle-8.5
• macOS/Linux: /usr/local/gradle/gradle-8.5

建议将解压后的文件夹重命名为简洁名称（如 gradle），便于后续配置。

4. 配置环境变量

将 Gradle 的 bin 目录添加到系统 PATH 中，以便在任意位置运行 gradle 命令。

Windows 配置方法：

1. 右键“此电脑” → “属性” → “高级系统设置”
2. 点击“环境变量”
3. 在“系统变量”中新建变量名：GRADLE_HOME，值为 Gradle 安装路径（如 C:\gradle\gradle-8.5）
4. 编辑 Path 变量，新增一项：%GRADLE_HOME%\bin

macOS/Linux 配置方法：

编辑 shell 配置文件（根据使用的 shell）：

• Bash: 编辑 ~/.bashrc 或 ~/.bash_profile
• Zsh: 编辑 ~/.zshrc

添加以下内容：

export GRADLE_HOME=/usr/local/gradle/gradle-8.5
export PATH=$GRADLE_HOME/bin:$PATH

保存后执行命令使配置生效：

source ~/.zshrc  # 或对应配置文件

5. 验证安装

打开新的终端或命令行窗口，输入：

gradle -v

如果显示 Gradle 版本信息、Groovy 版本、JVM 信息等，说明安装成功。

6. （可选）配置 Gradle 全局属性

可在用户目录下创建 ~/.gradle/gradle.properties 文件，用于设置全局参数，例如：

org.gradle.daemon=true
org.gradle.parallel=true
org.gradle.jvmargs=-Xmx2048m

这有助于提升构建性能。

7. 使用 Gradle 初始化项目（测试）

创建一个测试目录并初始化简单项目：

mkdir my-gradle-project
cd my-gradle-project
gradle init

按提示选择项目类型，Gradle 会自动生成基本结构和 build.gradle 文件。

基本上就这些。Gradle 环境搭建完成后，就可以开始构建 Java、Kotlin 或 Android 项目了。注意保持 Gradle 和 JDK 版本兼容，避免运行时报错。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。