开发环境搭建：JDK安装与配置、Gradle SDK安装、IDE配置与第一个Hello World

说实话，很多人学Gradle的第一步就卡在环境搭建上。

不是装错版本，就是配置漏了环境变量。更头疼的是JDK版本跟Gradle不兼容，折腾一整天连个Hello World都跑不起来。我早期带团队时就遇到过这种事——一个新人花了两天搭环境，结果发现装了Java 8和Gradle 7.x，根本跑不了。所以我决定把这章写得细一点，你跟着一步步来，20分钟内搞定。

这章的知识点其实就四个模块，我习惯用一个流程图先理清关系：

1. JDK安装与配置：这是地基

Gradle本质上是JVM上的构建工具。没有JDK，它就是个空壳。我的习惯是装LTS版本，目前JDK 17性价比最高。

第一步：下载JDK

• 推荐 Adoptium Temurin（原AdoptOpenJDK）或 Oracle JDK 17 LTS
• 选择对应操作系统的.msi/.dmg/.tar.gz

第二步：配置环境变量

以Windows为例。安装完成后，打开系统环境变量：

JAVA_HOME  = C:\Program Files\Java\jdk-17.0.5
Path       = %JAVA_HOME%\bin（追加到最前面）

macOS/Linux用户编辑 ~/.bashrc 或 ~/.zshrc：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

2. Gradle SDK安装：两种方式，随你选

我个人更推荐用SDKMAN（macOS/Linux）或者直接解压zip。为什么？稳定，可控。包管理器的版本有时候滞后。

方式A：手动安装（全平台通用）

1. 去 gradle.org/releases 下载 binary-only 的zip（大约100MB）
2. 解压到 C:\gradle-8.5 或 /opt/gradle-8.5
3. 配置环境变量：

GRADLE_HOME = C:\gradle-8.5
Path        = %GRADLE_HOME%\bin（追加）

# macOS/Linux
export GRADLE_HOME=/opt/gradle-8.5
export PATH=$GRADLE_HOME/bin:$PATH

方式B：SDKMAN（仅macOS/Linux/WSL）

一条命令搞定：

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

验证安装：

gradle -v

你会看到Gradle版本、JVM信息、操作系统详情。看到这些基本就稳了。

3. IntelliJ IDEA配置：让它认识Gradle

IntelliJ IDEA 2021以上版本对Gradle的支持已经很成熟了。但默认情况下它会用IDEA自带的Gradle wrapper，如果你想让项目使用你刚装的本地Gradle，需要手动设置一下。

配置步骤：

1. 打开 IntelliJ IDEA → File → Settings → Build, Execution, Deployment → Build Tools → Gradle
2. 在 Gradle user home 指定本地仓库路径（如 C:/Users/你的用户名/.gradle）
3. 在 Use Gradle from 选择「Specified location」→ 浏览到你刚才解压的Gradle目录
4. JVM配置：选择JDK 17或更高版本

还记得有一次我帮同事排查构建失败，IDEA的Gradle配置用的是默认的wrapper，结果wrapper指向的Gradle版本和项目不兼容。手动改成本地Gradle后，问题秒杀。

4. 第一个Hello World构建：见证奇迹

环境搭好了，我们来写一个最简单的构建脚本。

步骤一：创建项目目录

mkdir my-first-gradle
cd my-first-gradle

步骤二：创建 build.gradle 文件

用文本编辑器新建一个文件，命名为 build.gradle，内容如下：

tasks.register('hello') {
    doLast {
        println 'Hello, Gradle World!'
    }
}

这里注册了一个名为 hello 的任务，在 doLast 闭包里打印一句话。很简单吧？

步骤三：运行任务

在终端中进入项目目录，执行：

gradle hello

你应该看到类似这样的输出：

BUILD SUCCESSFUL in 1s
1 actionable task: 1 executed
Hello, Gradle World!

嗯，到这里你的Gradle环境已经通了。如果你看到的是报错，别慌——99%的问题出在环境变量或JDK版本上，回头检查一下那两步。

这一章的核心表格：常见问题与解决

症状	原因	解决方案
'gradle' 不是内部或外部命令	环境变量 Path 未配置或配置错误	检查 GRADLE_HOME 和 %GRADLE_HOME%\bin 是否在 Path 中
Unsupported major.minor version 61.0	JDK版本过老（Java 8不支持Gradle 8.x）	升级到 JDK 17 或使用 Gradle 7.6 (最后支持JDK 8的版本)
Could not find or load main class org.gradle.wrapper.GradleWrapperMain	Gradle wrapper jar 缺失或损坏	在项目根目录执行 gradle wrapper 重新生成
IDE 无法识别 Gradle 任务	IDEA 的 Gradle 配置中的 JDK 与本地不一致	统一设置 JDK，并确保 Gradle JVM 指向相同版本

其实你想想，环境搭建这件事本身没有任何技术深度，但它是第一道坎。跨过去了，后面学 Gradle 的 DSL、依赖管理、多项目构建，都会顺畅很多。我当年也是被 JDK/Gradle 版本冲突绊过一跤，从那以后我项目里统一写了 gradle-wrapper.properties 的版本号，并加了个脚本自动检查 JDK 版本——这些实战技巧后面会慢慢讲。