📋 前置條件

🎯 在開始之前，請打開終端并運行以下命令以確保已安裝正確版本的 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 核心組件。