当前位置:

首页 > 编程开发 > gradle安装步骤详解及环境变量配置教程

gradle安装步骤详解及环境变量配置教程

本文详细介绍Gradle的下载、解压、环境变量配置步骤以及安装验证方法,帮助开发者快速完成Gradle本地开发环境搭建。

安装 Gradle 需要完成 JDK 环境准备、二进制包下载解压、系统环境变量配置以及版本验证四个核心步骤。Gradle 作为基于 Apache Ant 和 Apache Maven 概念的现代项目自动化构建工具,其正确运行高度依赖 Java 运行环境。本教程将带您逐步完成本地环境的搭建配置。

一、 前置准备与核心依赖关系

在下载 Gradle 之前,系统必须正确安装 Java 开发工具包(JDK)。Gradle 对 JDK 版本有明确的要求:较新版本的 Gradle 通常需要 JDK 17 或更高版本。可以通过命令行执行 java -version 来确认当前环境是否满足条件。

gradle安装步骤详解及环境变量配置教程
图 1:Gradle 运行环境依赖与准备阶段逻辑关系图

二、 下载与解压 Gradle 二进制包

访问 Gradle 官方网站的发布页面,下载对应版本的二进制分发包(文件名通常类似 gradle-X.X-bin.zip)。建议下载编译好的二进制包(Binary-only),无需下载包含源码的完整包,以减少文件体积。

下载完成后,将压缩包解压到您计划长期存放软件的目录下。例如在 Windows 系统中解压至 C:\Gradle\gradle-8.8,或在 macOS / Linux 系统中解压至 /opt/gradle/gradle-8.8。

gradle安装步骤详解及环境变量配置教程
图 2:Gradle 解压后核心目录结构及可执行文件分布

三、 配置系统环境变量

为了能够在任意终端窗口中直接运行 Gradle 命令,必须将 Gradle 的执行路径配置到操作系统的环境变量中。

1. Windows 系统配置

  1. 在桌面上右键点击“此电脑”或“计算机”,选择“属性” -> “高级系统设置” -> “环境变量”。
  2. 在“系统变量”区域,点击“新建”按钮创建新变量:
    • 变量名:GRADLE_HOME
    • 变量值:C:\Gradle\gradle-8.8(即解压的实际根目录路径)
  3. 在系统变量列表中找到名为 Path 的变量,选中后点击“编辑”。
  4. 点击“新建”,输入表达式:%GRADLE_HOME%\bin,然后点击确定保存所有对话框。

2. macOS / Linux 系统配置

打开终端,根据使用的 Shell 类型(Zsh 或 Bash)编辑对应的配置文件(如 ~/.zshrc 或 ~/.bash_profile),在文件末尾追加以下内容:

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

保存文件后,在终端执行以下命令使配置立即生效:

source ~/.zshrc
gradle安装步骤详解及环境变量配置教程
图 3:环境变量配置核心逻辑流程图

四、 验证安装结果与常见问题排查

完成环境变量配置后,打开一个新的命令行终端窗口(注意:旧的终端窗口无法立即获取更新后的环境变量),输入以下命令检查安装状态:

gradle -v

若配置正确,终端将输出类似以下的版本信息示例:

------------------------------------------------------------
Gradle 8.8
------------------------------------------------------------

Build time:   2024-05-01 00:00:00 UTC
Revision:     abcdef1234567890

Kotlin:       1.9.22
Groovy:       3.0.17
Ant:          Apache Ant(TM) version 1.10.13
JVM:          17.0.11 (Oracle Corporation 17.0.11+7-LTS-207)
OS:           Windows 10 10.0 amd64
注意事项:如果提示 'gradle' 不是内部或外部命令,通常是因为 PATH 变量中未正确包含 bin 目录,或者终端未重新开启。如果提示 JAVA_HOME is not set,说明操作系统的 JDK 环境变量未被正确识别。
gradle安装步骤详解及环境变量配置教程
图 4:验证结果判定与常见排查路径总结图
本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
作者最新文章
编程开发
相关文章 更多
google adk install Python环境安装教程
google adk install Python环境安装教程

本教程详细介绍 Google ADK(Android Accessory Development Kit)在 Python 环境下的安装与配置方法,涵盖 Python 基础环境检查、虚拟环境搭建、依赖库与包安装、以及硬件通信权限排查。

PHP递归遍历目录文件:RecursiveDirectoryIterator与自定义实现
PHP递归遍历目录文件:RecursiveDirectoryIterator与自定义实现

深入解析在PHP中递归遍历多级目录文件的两种核心方案:基于SPL标准库的RecursiveDirectoryIterator高效流式迭代,与基于scandir/opendir的自定义递归函数实现,剖析执行机制、内存表现与实战避坑指南。

shell脚本怎么执行命令并获取执行结果的方法
shell脚本怎么执行命令并获取执行结果的方法

详细讲解在Shell脚本中执行命令并获取执行结果的常用方法,涵盖标准输出捕获、退出状态码判断、错误流重定向、多行结果处理及常见避坑要点。

Java变量声明与初始化:局部、成员及静态变量的定义语法
Java变量声明与初始化:局部、成员及静态变量的定义语法

系统解析Java局部变量、成员变量与静态变量的定义语法、声明与初始化机制、生命周期及JVM内存驻留规则,结合图解与代码示例分析常见编译错误与认知误区。

windows claude code 安装
windows claude code 安装

详解如何在Windows 10/11上安装Claude Code。涵盖WSL与Git Bash终端选择、Node.js版本检查、npm全局安装步骤、身份验证流程及claude doctor诊断方法,帮助开发者快速搭建本地AI编码助手。

typescript是什么语言?一文看懂其定义与用途
typescript是什么语言?一文看懂其定义与用途

深入浅出解析TypeScript是什么语言。本文详细介绍TypeScript的语言定义、超集架构、核心运行原理、与JavaScript的核心对比以及四类典型工业级应用场景,帮助读者全面看懂TS的价值与用途。

codex安装windows教程桌面版完整安装步骤指南
codex安装windows教程桌面版完整安装步骤指南

详解如何在 Windows 电脑上通过 Microsoft Store 安装 Codex 桌面应用,包括启动登录、切换 Codex 模式、关联本地代码项目及终端环境配置的界面操作指引。

github配置ssh key windows
github配置ssh key windows

本文详解如何在Windows环境中使用PowerShell生成SSH密钥对,配置ssh-agent自动加载私钥,并将公钥安全添加至GitHub账户,最后通过git remote set-url切换为SSH地址,解决每次操作需输入账号密码的问题。

backdrop和background区别
backdrop和background区别

深入解析backdrop与background在网页开发及视觉设计中的区别。通过CSS代码示例,展示如何正确使用background设置元素背景,以及利用backdrop-filter创建弹窗遮罩模糊效果,避免概念混用。

windsurf ide download Windows版安装教程
windsurf ide download Windows版安装教程

详解 Windsurf IDE 在 Windows 系统的下载来源、安装步骤及首次启动界面。指导用户如何导入编辑器设置、打开项目文件夹及使用终端与 AI 功能,适合初次接触该工具的开发者阅读。

查看更多
精品专题 更多
装机必备
装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows
Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

PDF教程
PDF教程

正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

Mac软件 更多
WPS Office macOS版
WPS Office macOS版
macOS

WPS Office是一款面向macOS用户的综合办公套件,将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式,支持Intel及Apple芯片Mac,基础功能可免费使用,

Shapr3D macOS版
Shapr3D macOS版
Mac

Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核,支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换,并可通过账户在多台设备之间同步项目。

REAPER macOS版
REAPER macOS版
Mac

REAPER是Cockos开发的数字音频工作站,提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片,支持AU、VST、VST3、CLAP等插件格式,并提供高度可定制的工作流程。

WINDOWS 更多
Adobe Photoshop Windows版
Adobe Photoshop Windows版
Windows

Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具,可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权,由 Creative Cloud 管理安装、更新与许

Adobe InDesign Windows版
Adobe InDesign Windows版
Windows

Adobe InDesign 是面向印刷与数字出版的专业页面排版工具,可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力,并能与 Photoshop、Illustrator

Adobe Illustrator Windows版
Adobe Illustrator Windows版
Windows

Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心,作品放大后仍能保持清晰,并提供画板、文字、渐变、图像描摹及精确变换等功能,适合品牌视觉、印刷物料、数字界面和商业插画创作。