如何在MacOS中配置Gradle开发环境

首先安装JDK并配置JAVA_HOME,再通过Homebrew安装Gradle或手动解压配置GRADLE_HOME,最后验证gradle -v并创建测试项目确认环境正常。

在MacOS中配置G

radle开发环境并不复杂,只要正确安装并设置好相关路径即可。Gradle常用于Java、Kotlin等项目的构建,配合IntelliJ IDEA或命令行使用非常方便。

安装Java环境

Gradle依赖Java运行,因此必须先确保系统中已安装JDK。

- 打开终端,输入 java -version 查看是否已安装Java。
- 若未安装,建议下载并安装JDK 11或JDK 17(推荐LTS版本),可从Eclipse Adoptium获取。
- 安装完成后,设置JAVA_HOME环境变量(可选但推荐):

编辑 ~/.zshrc 文件(默认Shell为zsh):

export JAVA_HOME=$(/usr/libexec/java_home)
export PATH=$JAVA_HOME/bin:$PATH

保存后执行 source ~/.zshrc 使配置生效。

安装Gradle

推荐使用包管理工具Homebrew安装,简单高效。

- 若未安装Homebrew,先在终端运行官方安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 使用Homebrew安装Gradle:
brew install gradle

安装完成后,输入 gradle -v 验证是否成功。若显示Gradle版本和Java信息,则说明安装成功。

手动安装Gradle(可选方式)

如果不想用Homebrew,也可以手动安装。

- 前往Gradle官网下载二进制发行版(如gradle-x.x-bin.zip)。
- 解压到指定目录,例如:/usr/local/gradle/gradle-x.x
- 配置环境变量:

编辑 ~/.zshrc 文件:

export GRADLE_HOME=/usr/local/gradle/gradle-x.x
export PATH=$GRADLE_HOME/bin:$PATH

保存后运行 source ~/.zshrc 刷新配置,再用 gradle -v 测试。

验证与使用

创建一个简单的测试项目来确认环境正常工作。

- 新建目录并进入:mkdir hello-gradle && cd hello-gradle
- 初始化项目:gradle init --type java-application
- 构建项目:gradle build

如果构建成功,说明Gradle环境已正确配置。

基本上就这些。只要Java和Gradle都装好了,并且环境变量设置正确,就能顺利开始开发。后续可在IntelliJ IDEA中直接导入Gradle项目,IDE会自动识别build.gradle文件。不复杂但容易忽略细节,比如shell配置文件选对了没有(.zshrc 而不是 .bash_profile)。