第一个 Gradle 项目实战：用 build.gradle 完成 Java 项目的编译与打包

第一个 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：手动下载安装（推荐，版本可控）

1. 访问 Gradle 官网下载页，选择 Binary-only 版本（如 gradle-8.8-bin.zip），下载后解压到本地目录（如 D:\tools\gradle-8.8）。
2. 配置环境变量：
   • 新增系统变量 GRADLE_HOME，值为 Gradle 解压路径（如 D:\tools\gradle-8.8）。
   • 在系统变量 Path 中添加 %GRADLE_HOME%\bin（Windows）或 $GRADLE_HOME/bin（Mac/Linux）。
3. 验证安装：打开新终端，执行以下命令，输出版本号即成功：

   gradle -v
   

方式 2：通过 IDE 自动集成（适合新手）

IntelliJ IDEA 或 Eclipse 均自带 Gradle 插件，可在创建项目时自动下载并配置 Gradle，无需手动操作（下文以 IDEA 为例）。

二、初始化 Java 项目：两种方式

Gradle 支持命令行初始化和IDE 可视化创建，两种方式最终生成的项目结构一致，可根据习惯选择。

方式 1：命令行初始化（推荐，理解项目结构）

1. 打开终端，进入要创建项目的目录（如 D:\projects）。

2. 执行 Gradle 初始化命令，选择 Java 项目类型：

   gradle init
   

3. 按交互提示选择配置：

   • 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）。

4. 初始化完成后，项目结构如下（核心目录已标注）：

   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 可视化创建（更直观）

1. 打开 IDEA，点击 File > New > Project。
2. 左侧选择 Gradle > Java，右侧配置：
   • Project SDK：选择本地已安装的 JDK。
   • 勾选 Use Gradle wrapper (recommended)（使用 wrapper 确保版本一致）。
3. 点击 Next，输入项目名（如 gradle-java-demo）和包名（如 com.example.demo），点击 Finish。
4. IDEA 会自动下载 Gradle 并生成与命令行一致的项目结构。

三、核心配置：编写 build.gradle

build.gradle 是 Gradle 项目的“大脑”，所有构建逻辑（依赖、编译、打包）均通过此文件配置。以下是针对 Java 项目的完整配置，每部分均有详细注释。

完整 build.gradle 示例

// 1. 声明项目类型：Java 应用（自动引入 Java 插件和 Application 插件）
plugins {