gradle安装步骤详解及环境变量配置教程
本文详细介绍Gradle的下载、解压、环境变量配置步骤以及安装验证方法,帮助开发者快速完成Gradle本地开发环境搭建。
安装 Gradle 需要完成 JDK 环境准备、二进制包下载解压、系统环境变量配置以及版本验证四个核心步骤。Gradle 作为基于 Apache Ant 和 Apache Maven 概念的现代项目自动化构建工具,其正确运行高度依赖 Java 运行环境。本教程将带您逐步完成本地环境的搭建配置。
一、 前置准备与核心依赖关系
在下载 Gradle 之前,系统必须正确安装 Java 开发工具包(JDK)。Gradle 对 JDK 版本有明确的要求:较新版本的 Gradle 通常需要 JDK 17 或更高版本。可以通过命令行执行 java -version 来确认当前环境是否满足条件。
二、 下载与解压 Gradle 二进制包
访问 Gradle 官方网站的发布页面,下载对应版本的二进制分发包(文件名通常类似 gradle-X.X-bin.zip)。建议下载编译好的二进制包(Binary-only),无需下载包含源码的完整包,以减少文件体积。
下载完成后,将压缩包解压到您计划长期存放软件的目录下。例如在 Windows 系统中解压至 C:\Gradle\gradle-8.8,或在 macOS / Linux 系统中解压至 /opt/gradle/gradle-8.8。
三、 配置系统环境变量
为了能够在任意终端窗口中直接运行 Gradle 命令,必须将 Gradle 的执行路径配置到操作系统的环境变量中。
1. Windows 系统配置
- 在桌面上右键点击“此电脑”或“计算机”,选择“属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”区域,点击“新建”按钮创建新变量:
- 变量名:
GRADLE_HOME - 变量值:
C:\Gradle\gradle-8.8(即解压的实际根目录路径)
- 变量名:
- 在系统变量列表中找到名为
Path的变量,选中后点击“编辑”。 - 点击“新建”,输入表达式:
%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 -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 环境变量未被正确识别。
WPS Office是一款面向macOS用户的综合办公套件,将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式,支持Intel及Apple芯片Mac,基础功能可免费使用,
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核,支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换,并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站,提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片,支持AU、VST、VST3、CLAP等插件格式,并提供高度可定制的工作流程。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具,可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权,由 Creative Cloud 管理安装、更新与许
Adobe InDesign 是面向印刷与数字出版的专业页面排版工具,可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力,并能与 Photoshop、Illustrator
Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心,作品放大后仍能保持清晰,并提供画板、文字、渐变、图像描摹及精确变换等功能,适合品牌视觉、印刷物料、数字界面和商业插画创作。













