安装
当前的 Gradle 版本是 9.0.0。您可以从发布页面下载所有 Gradle 版本的二进制文件并查看文档。
先决条件
Gradle 可在所有主流操作系统上运行，并且仅需要安装 Java JDK 8 或更高版本。要检查您的版本，请运行 java -version。
$ java -version
java version "1.8.0_121"
其他资源
- Gradle 用户可以免费获得按需和直播的在线培训。
- 除了文档之外，自定进度的教程也是一个尝试在各种语言中使用 Gradle 的好地方。
- Gradle 有一个可视化的构建检查工具：Build Scan™。
- 最后，Gradle Newsletter 是保持
最新状态的好方法，每月都会精心制作一期。
使用包管理器安装
SDKMAN! 是一个在大多数类 Unix 系统上管理多个软件开发工具包并行版本的工具。
$ sdk install gradle 9.0.0
Homebrew 是“macOS 缺失的包管理器”。
$ brew install gradle
还有其他可用的包管理器，但它们分发的 Gradle 版本不受 Gradle, Inc. 控制。Linux 包管理器可能会分发一个修改过的 Gradle 版本，与官方版本（可从 SDKMAN! 或下方获取）相比，可能不兼容或不完整。
› 其他有用信息
手动安装
步骤 1. 下载最新的 Gradle 发行版
当前的 Gradle 版本是 9.0.0，发布于 2025 年 7 月 31 日。该发行版 zip 文件有两种类型：
需要使用旧版本？请参阅发布页面。
步骤 2. 解压发行包
Linux 和 MacOS 用户
将发行版 zip 文件解压到您选择的目录中，例如：
$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-9.0.0-bin.zip
$ ls /opt/gradle/gradle-9.0.0
LICENSE NOTICE bin getting-started.html init.d lib media
Microsoft Windows 用户
使用文件资源管理器创建一个新目录 C:\Gradle。
打开第二个文件资源管理器窗口，并转到下载 Gradle 发行版的目录。双击 ZIP 压缩包以显示其内容。将内容文件夹 gradle-9.0.0 拖到您新创建的 C:\Gradle 文件夹中。
或者，您可以使用您选择的解压工具将 Gradle 发行版 ZIP 解压到 C:\Gradle 中。
步骤 3. 配置您的系统环境
Linux 和 MacOS 用户
配置您的 PATH 环境变量，使其包含解压后发行版中的 bin 目录，例如：
$ export PATH=$PATH:/opt/gradle/gradle-9.0.0/bin
Microsoft Windows 用户
在文件资源管理器中，右键单击此电脑（或计算机）图标，然后单击属性 -> 高级系统设置 -> 环境变量。
在系统变量下选择 Path，然后单击编辑。为 C:\Gradle\gradle-9.0.0\bin 添加一个条目。单击“确定”保存。
步骤 4. 验证您的安装
打开一个控制台（或 Windows 命令提示符）并运行 gradle -v 来运行 gradle 并显示版本，例如：
$ gradle -v
------------------------------------------------------------
Gradle 9.0.0
------------------------------------------------------------
› 其他有用信息
使用 Gradle Wrapper 升级
如果您现有的基于 Gradle 的构建使用 Gradle Wrapper，您可以通过运行 wrapper 任务，并指定所需的 Gradle 版本来轻松升级：
$ ./gradlew wrapper --gradle-version=9.0.0 --distribution-type=bin
请注意，使用 Gradle Wrapper 并不需要安装 Gradle。下一次调用 gradlew 或 gradlew.bat 时，将会下载并缓存指定版本的 Gradle。
$ ./gradlew tasks
Downloading https://services.gradle.org/distributions/gradle-9.0.0-bin.zip
...
› 其他有用信息
旧版本
您可以在发布页面上找到所有版本及其校验和。
命令行补全
命令行补全脚本可用于 bash 和 zsh。这为 Gradle 任务和命令行选项提供了补全功能。