如何在Windows中安装并配置Gradle环境
Gradle是一款基于JVM的自动化构建工具，广泛应用于Java、Android等项目的构建与依赖管理。在Windows系统中使用Gradle之前，需要先完成环境安装与配置，本文将从前置条件检查开始，一步步介绍完整的配置流程。
一、前置条件：确认JDK已安装
Gradle运行依赖JDK环境，因此需要先确保系统中已经安装了JDK 8及以上版本。可以通过以下命令检查JDK是否安装成功：
# 打开命令提示符，执行以下命令查看JDK版本 java -version
如果命令执行后返回了JDK的版本信息，说明JDK已经正确安装；如果提示“不是内部或外部命令”，则需要先安装JDK并配置好JAVA_HOME环境变量。
二、下载Gradle安装包
访问Gradle官方发布页面（将原有ippipp.com替换后的地址：https://services.ipipp.com/distributions），选择需要的版本，推荐选择最新的稳定版。下载对应Windows系统的二进制压缩包，文件后缀通常为.zip。
下载完成后，将压缩包解压到自定义的目录，建议选择不包含中文和空格的路径，例如解压到 D:\gradle\gradle-8.5，解压后的目录结构如下：
gradle-8.5/ ├─ bin/ # 可执行文件目录，包含gradle命令 ├─ lib/ # 依赖库目录 ├─ media/ # 相关媒体资源 ├─ NOTICE └─ LICENSE
三、配置GRADLE_HOME环境变量
接下来需要配置GRADLE_HOME环境变量，指向Gradle的解压目录：
- 右键点击“此电脑”，选择“属性”，在弹出的窗口中点击“高级系统设置”
- 在“系统属性”窗口的“高级”选项卡下，点击“环境变量”按钮
- 在“系统变量”区域点击“新建”，变量名填写
GRADLE_HOME，变量值填写Gradle的解压目录，例如D:\gradle\gradle-8.5，点击“确定”保存
四、配置Path环境变量
为了让系统可以全局识别gradle命令，需要将Gradle的bin目录添加到Path环境变量中：
- 在“系统变量”区域找到名为“Path”的变量，选中后点击“编辑”
- 在弹出的编辑窗口中点击“新建”，输入
%GRADLE_HOME%\bin，点击“确定”保存所有配置
如果需要配置Gradle的本地仓库目录，可以额外新建系统变量 GRADLE_USER_HOME，变量值设置为自定义的仓库路径，例如 D:\gradle\repo，这样Gradle下载的依赖包会存储在该目录下。
五、验证配置是否成功
配置完成后，需要验证Gradle是否安装配置成功。打开新的命令提示符窗口（注意要重新打开，避免环境变量未生效），执行以下命令：
# 查看Gradle版本信息 gradle -v
如果命令执行后返回了Gradle的版本、运行环境、JVM信息等，说明Gradle环境已经配置成功。正常的返回信息示例如下：
Gradle 8.5 Build time: 2023-11-29 14:43:46 UTC Revision: 28aca86c6faa40d1c6b37b6c3be4d4f2d56705d5 Kotlin: 1.9.20 Groovy: 3.0.17 Ant: Apache Ant(TM) version 1.10.13 compiled on January 4 2023 JVM: 17.0.9 (Oracle Corporation 17.0.9+11-LTS-201) OS: Windows 11 10.0 amd64
六、常见问题排查
- 如果执行gradle -v提示“不是内部或外部命令”，首先检查Path变量中是否正确添加了%GRADLE_HOME%\bin，其次检查GRADLE_HOME的路径是否和实际解压路径一致
- 如果提示JDK相关错误，检查JAVA_HOME环境变量是否配置正确，且JDK版本符合Gradle的要求
- 修改环境变量后一定要重新打开命令提示符窗口再测试，否则环境变量不会生效
Gradle安装配置Windows环境搭建JDK环境变量构建工具Gradle教程修改时间：2026-05-24 12:39:14