📋 前置条件

🎯 在开始之前，请打开终端并运行以下命令以确保已安装正确版本的 Java：

$ java -version
openjdk version "17.0.4.1" 2022-08-12 LTS
OpenJDK Runtime Environment (build 17.0.4.1+1-LTS)
OpenJDK 64-Bit Server VM (build 17.0.4.1+1-LTS, mixed mode, sharing)

⚠️ | 注意 | 本示例需要在独立目录中创建。后续操作假设您已创建合适目录并已切换至该目录。

---

🔧 构建工具配置

1️⃣ Maven 配置

🔍 若使用 Maven 构建工具，请验证安装情况：

$ mvn -v
Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
Maven home: usr/Users/developer/tools/maven/3.8.5
Java version: 17.0.4.1, vendor: BellSoft, runtime: /Users/developer/sdkman/candidates/java/17.0.4.1-librca

2️⃣ Gradle 配置

🔍 若使用 Gradle 构建工具，请验证安装情况：

$ gradle --version------------------------------------------------------------
Gradle 8.1.1
------------------------------------------------------------Build time:   2023-04-21 12:31:26 UTC
Revision:     1cf537a851c635c364a4214885f8b9798051175bKotlin:       1.8.10
Groovy:       3.0.15
Ant:          Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM:          17.0.7 (BellSoft 17.0.7+7-LTS)
OS:           Linux 6.2.12-200.fc37.aarch64 aarch64

---

🧩 Maven 项目配置

📝 首先创建 Maven 的 pom.xml 文件，这个文件是项目的构建蓝图：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>myproject</artifactId><version>0.0.1-SNAPSHOT</version><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.4.5</version></parent><!-- 后续添加其他配置 -->
</project>

🔄 运行 mvn package 命令可验证配置（暂时可忽略"jar will be empty"的警告提示）。

💡 | 说明 | 此时可将项目导入 IDE 开发环境（主流 Java IDE 均内置 Maven 支持）。为保持示例简洁，我们继续使用文本编辑器操作。

---

🧩 Gradle 项目配置

📝 首先创建 Gradle 的 build.gradle 构建脚本：

plugins {id 'java'id 'org.springframework.boot' version '3.4.5'
}apply plugin: 'io.spring.dependency-management'group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'repositories {mavenCentral()
}dependencies {
}

🔄 运行 gradle classes 命令可验证基础配置。

💡 | 说明 | 此时也可将项目导入 IDE 开发环境（主流 IDE 均支持 Gradle）。为保持过程简洁，我们继续使用文本编辑器操作。

---

📦 添加依赖项

✨ Spring Boot 提供多种 starter 组件，可便捷管理依赖项。这些 starter 包含了开发特定类型应用所需的常用库。

1️⃣ Maven 项目

📌 在 POM 文件的 <parent> 节点中引用 spring-boot-starter-parent 能够获得：

• 智能化的 Maven 默认配置
• 依赖版本自动管理功能（对标注为"blessed"的依赖可省略版本号）

🌐 需要添加 spring-boot-starter-web 依赖。添加前可通过以下命令查看当前依赖树：

$ mvn dependency:tree
[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT

📌 在 <parent> 节点下方添加依赖配置：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
</dependencies>

🔄 再次运行依赖树查看命令，可见新增了 Tomcat 服务器和 Spring Boot 核心库等依赖。

---

2️⃣ Gradle 项目

📌 通过 org.springframework.boot 插件可获得：

• 智能化的 Gradle 任务配置
• 通过 io.spring.dependency-management 插件实现的依赖版本管理

🌐 添加 Web 应用依赖前，先查看当前依赖树：

$ gradle dependencies
> Task :dependencies
Root project 'myproject'

📌 在 dependencies 节点中添加配置：

dependencies {implementation 'org.springframework.boot:spring-boot-starter-web'
}

🔄 再次执行依赖分析后，可见已成功引入 Tomcat 服务器和 Spring Boot 核心组件。