可通过Homebrew在Mac上快速安装配置Gradle：先确保Homebrew已安装并更新，再执行brew install gradle；验证Java环境兼容性，设置JAVA_HOME指向JDK 11+；用gradle init创建Java项目并运行./gradlew build测试；可选配置阿里云Maven镜像加速依赖下载。

如果您希望在Mac系统上为Java项目构建环境安装并配置Gradle，则可通过Homebrew这一包管理器快速完成。以下是具体操作步骤：

一、确认Homebrew已安装并更新

Homebrew是Mac上最常用的命令行包管理工具，Gradle的安装依赖其存在。若尚未安装Homebrew，需先执行安装命令；若已安装，则需确保其版本为最新，以避免因仓库索引过期导致Gradle安装失败。

1、打开终端应用程序（位于“应用程序 → 实用工具”中）。

2、输入命令 which brew 并回车，检查是否返回类似 /opt/homebrew/bin/brew 的路径。

立即学习“Java免费学习笔记（深入）”；

3、若未返回路径，执行安装命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。

4、若已安装，运行 brew update 更新公式库。

二、使用brew安装Gradle

Gradle官方维护了Homebrew Formula，通过brew install可直接下载预编译的二进制包并完成软链接配置，无需手动解压或设置PATH。

1、在终端中执行命令：brew install gradle。

2、等待安装完成，过程中brew会自动处理依赖（如OpenJDK，若系统未安装兼容JDK则可能提示安装）。

3、安装结束后，执行 gradle -v 验证是否输出版本信息（含Gradle版本、Kotlin版本、Groovy版本及JVM信息）。

三、验证Java环境兼容性

Gradle构建Java项目需匹配的JDK版本。brew安装的Gradle默认支持JDK 11及以上，但若系统中存在多个JDK版本，需确保JAVA_HOME指向兼容版本，否则执行gradle命令时可能报错“Unsupported Java version”。

1、运行 /usr/libexec/java_home -V 列出所有已安装JDK路径及版本。

2、选择一个版本号≥11的JDK路径（例如 /opt/homebrew/Cellar/openjdk@17/17.0.2/libexec/openjdk.jdk）。

3、将该路径写入shell配置文件：若使用zsh（macOS Catalina及以后默认），编辑 ~/.zshrc；若使用bash，编辑 ~/.bash_profile。

4、在配置文件末尾添加一行：export JAVA_HOME=$(/usr/libexec/java_home -v 17)（请将17替换为实际选用的主版本号）。

5、执行 source ~/.zshrc（或对应配置文件）使变量生效。

四、初始化一个Gradle Java项目进行测试

安装完成后，可通过创建最小化Java项目验证Gradle是否能正常驱动构建流程，包括编译、测试和打包环节。

1、新建项目目录并进入：mkdir hello-gradle && cd hello-gradle。

2、执行初始化命令：gradle init --type java-application。

3、按提示选择构建语言（默认Kotlin DSL或选择Groovy）、项目包名（如 com.example）及项目名称。

4、生成完成后，运行 ./gradlew build 执行完整构建流程。

5、检查 build/libs/ 目录下是否生成了JAR文件，且文件名包含 -all 后缀（表示包含依赖的可执行包）。

五、配置Gradle全局属性与镜像加速（可选）

国内用户直连Gradle官方仓库常面临超时或依赖下载失败问题，可通过配置GRADLE_USER_HOME下的init.gradle或使用阿里云镜像仓库提升下载效率。

1、创建Gradle用户目录：mkdir -p ~/.gradle/init.d。

2、新建初始化脚本：touch ~/.gradle/init.d/repo-init.gradle。

3、用文本编辑器打开该文件，写入以下内容：

allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public' } mavenCentral() } }

4、保存后，后续所有Gradle项目（包括通过gradle init生成的项目）将自动使用阿里云Maven镜像拉取依赖。