第一个 Gradle 项目实战：Java 项目的编译与打包
本实战将从环境准备到最终打包，完整演示如何用 Gradle 的 build.gradle 配置文件完成 Java 项目的构建流程，涵盖项目初始化、依赖管理、编译配置、打包设置等核心步骤，适合 Gradle 新手快速上手。
一、前置准备：安装 Gradle 与配置环境
在开始项目前，需先确保本地已安装 Gradle 并配置好环境（Gradle 自带 Groovy 解析器，无需额外安装 Groovy）。
1. 检查 Java 环境（必需）
Gradle 运行依赖 JDK（推荐 JDK 8 及以上），先验证本地 JDK 是否正常：
# 执行命令，若输出 JDK 版本（如 1.8.0_301）则正常
java -version
2. 安装 Gradle
方式 1：手动下载安装（推荐，版本可控）
访问 Gradle 官网下载页，选择 Binary-only 版本（如 gradle-8.8-bin.zip），下载后解压到本地目录（如 D:\tools\gradle-8.8）。
配置环境变量：
新增系统变量 GRADLE_HOME，值为 Gradle 解压路径（如 D:\tools\gradle-8.8）。
在系统变量 Path 中添加 %GRADLE_HOME%\bin（Windows）或 $GRADLE_HOME/bin（Mac/Linux）。
验证安装：打开新终端，执行以下命令，输出版本号即成功：gradle -v
方式 2：通过 IDE 自动集成（适合新手）
IntelliJ IDEA 或 Eclipse 均自带 Gradle 插件，可在创建项目时自动下载并配置 Gradle，无需手动操作（下文以 IDEA 为例）。
二、初始化 Java 项目：两种方式
Gradle 支持命令行初始化和IDE 可视化创建，两种方式最终生成的项目结构一致，可根据习惯选择。
方式 1：命令行初始化（推荐，理解项目结构）
打开终端，进入要创建项目的目录（如 D:\projects）。
执行 Gradle 初始化命令，选择 Java 项目类型：
gradle init
按交互提示选择配置：
Select type of project to generate：选择 application（生成可运行的 Java 应用，含主类）。
Select implementation language：选择 Java。
Select build script DSL：选择 Groovy（Gradle 默认 DSL，脚本文件为 build.gradle）。
Select test framework：选择 JUnit Jupiter（主流 Java 测试框架）。
Enter project name：输入项目名（如 gradle-java-demo）。
Enter source package：输入源码包名（如 com.example.demo）。
初始化完成后，项目结构如下（核心目录已标注）：
gradle-java-demo/
├── .gradle/ # Gradle 缓存目录（无需手动修改）
├── gradle/ # Gradle wrapper 目录（含 wrapper 脚本，确保团队版本一致）
│ └── wrapper/
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties # 配置 Gradle 版本
├── src/ # 源码与测试代码目录（核心）
│ ├── main/ # 主代码目录
│ │ ├── java/ # Java 源码目录
│ │ │ └── com/
│ │ │ └── example/
│ │ │ └── demo/
│ │ │ └── App.java # 主类（含 main 方法）
│ │ └── resources/ # 资源文件目录（如配置文件、图片）
│ └── test/ # 测试代码目录
│ ├── java/
│ │ └── com/
│ │ └── example/
│ │ └── demo/
│ │ └── AppTest.java # 测试类
│ └── resources/ # 测试资源目录
├── .gitignore # Git 忽略文件
├── build.gradle # Gradle 核心配置文件（本次实战重点）
├── gradlew # Linux/Mac 下的 Gradle wrapper 脚本（无需安装 Gradle 也能运行）
├── gradlew.bat # Windows 下的 Gradle wrapper 脚本
└── settings.gradle # 项目设置（如项目名、子模块）
方式 2：IDEA 可视化创建（更直观）
打开 IDEA，点击 File > New > Project。
左侧选择 Gradle > Java，右侧配置：
Project SDK：选择本地已安装的 JDK。
勾选 Use Gradle wrapper (recommended)（使用 wrapper 确保版本一致）。
点击 Next，输入项目名（如 gradle-java-demo）和包名（如 com.example.demo），点击 Finish。
IDEA 会自动下载 Gradle 并生成与命令行一致的项目结构。
三、核心配置：编写 build.gradle
build.gradle 是 Gradle 项目的“大脑”，所有构建逻辑（依赖、编译、打包）均通过此文件配置。以下是针对 Java 项目的完整配置，每部分均有详细注释。
完整 build.gradle 示例
// 1. 声明项目类型：Java 应用（自动引入 Java 插件和 Application 插件）
plugins {