macOS 安装

本文介绍在 macOS 上安装 Gradle 的几种方式，推荐使用 SDKMAN 或 Homebrew。

前置要求

# 确认 Java 已安装
java -version
# java version "17.0.9" 2023-10-17 LTS

方式一：SDKMAN（强烈推荐）

SDKMAN 是专门管理 JVM 生态工具（Gradle、Maven、Java、Kotlin 等）的版本管理器，类似 Node.js 的 nvm。

安装 SDKMAN

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

安装 Gradle

# 安装最新版本
sdk install gradle

# 安装指定版本
sdk install gradle 8.5

# 查看所有可用版本
sdk list gradle

版本管理

# 切换版本
sdk use gradle 8.4

# 设置默认版本
sdk default gradle 8.5

# 查看当前版本
sdk current gradle

方式二：Homebrew

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Gradle
brew install gradle

# 更新 Gradle
brew upgrade gradle

# 验证
gradle -v

方式三：手动安装

1. 下载

# 下载 Gradle 8.5
curl -L https://services.gradle.org/distributions/gradle-8.5-bin.zip -o gradle-8.5-bin.zip

2. 解压

mkdir -p ~/tools/gradle
unzip gradle-8.5-bin.zip -d ~/tools/gradle

3. 配置环境变量

编辑 ~/.zshrc（zsh，macOS 默认）或 ~/.bashrc（bash）：

export GRADLE_HOME=~/tools/gradle/gradle-8.5
export PATH=$PATH:$GRADLE_HOME/bin

# 使配置生效
source ~/.zshrc

4. 验证

gradle -v

配置镜像加速

创建全局初始化脚本 ~/.gradle/init.gradle：

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

下一步

• SDKMAN 安装 - 详细的 SDKMAN 使用指南
• Gradle Wrapper - 项目级 Gradle 版本管理
• Hello World - 第一个 Gradle 项目