工欲善其事，必先利其器。本章逐一安裝並驗證開發所需的工具。 如果某項工具已經安裝，直接執行對應的「驗證指令」確認版本即可。

工具總覽

lP5.6cml 工具 & 用途 & 驗證指令
JDK 17+ & 編譯與執行 Java 程式 &
Maven 3.9+ & 建置專案、管理相依套件 &
MySQL 8 & 關聯式資料庫 &
Docker Desktop & 建置與執行容器 &
Postman & 測試 REST API & （圖形介面程式）
IDE & 撰寫程式（IntelliJ IDEA / VS Code）& （圖形介面程式）

安裝 JDK 17

Spring Boot 3.x 最低需求為 Java 17。推薦安裝長期支援（LTS）版本：17 或 21。

macOS（使用 Homebrew）：

# 安裝 OpenJDK 17（Temurin 與 openjdk 擇一即可）
brew install openjdk@17

# 驗證安裝
java -version
# 預期輸出類似：
# openjdk version "17.0.12" 2024-07-16

Windows：至 https://adoptium.net 下載 Eclipse Temurin 17 的安裝檔， 安裝時勾選「Set JAVA_HOME」與「Add to PATH」。

安裝 Maven

Maven 負責下載相依套件與建置專案。

# macOS
brew install maven

# 驗證安裝
mvn -v
# 預期輸出類似：
# Apache Maven 3.9.x

用 Spring Initializr 建立的專案通常附有 （Maven Wrapper）腳本， 執行 會自動下載指定版本的 Maven， 即使電腦沒安裝 Maven 也能建置專案，也確保團隊成員使用相同版本。

準備 MySQL 8

三種方式擇一即可。最推薦方式 C（Docker）——不污染本機環境， 版本切換容易，砍掉重練也只要一行指令。

方式 A：macOS 使用 Homebrew

brew install mysql
brew services start mysql          # 啟動 MySQL 服務
mysql_secure_installation          # 設定 root 密碼（本教材假設為 root1234）

方式 B：Windows 官方安裝程式

至 https://dev.mysql.com/downloads/installer/ 下載 MySQL Installer， 選擇「Server only」安裝，過程中設定 root 密碼。

方式 C：使用 Docker（推薦）

安裝好 Docker Desktop（見 1.5 節）後，一行指令啟動 MySQL：

# 啟動 MySQL 8.4 容器：
#   --name  容器名稱
#   -e      設定環境變數（root 密碼、預設建立的資料庫）
#   -p      連接埠對映「本機:容器」
#   -d      在背景執行
docker run --name bookstore-mysql \
  -e MYSQL_ROOT_PASSWORD=root1234 \
  -e MYSQL_DATABASE=bookstore_db \
  -p 3306:3306 \
  -d mysql:8.4

# 確認容器正在執行
docker ps

# （選用）進入 MySQL 命令列
docker exec -it bookstore-mysql mysql -uroot -proot1234

本教材的預設連線設定為：主機 、連接埠 、 帳號 、密碼 、資料庫 。 若你的環境不同，請記下你的設定，第 3 章會說明如何調整 。

安裝 Docker Desktop

至 https://www.docker.com/products/docker-desktop/ 下載並安裝 Docker Desktop（macOS / Windows 皆同）。安裝後啟動 Docker Desktop 應用程式， 等待狀態列圖示顯示執行中，再驗證：

docker --version          # Docker version 27.x ...
docker run hello-world    # 會下載並執行測試容器，印出 Hello from Docker!

Docker 指令失敗顯示 時， 表示 Docker Desktop 沒有啟動——先打開 Docker Desktop 應用程式即可。

安裝 Postman

至 https://www.postman.com/downloads/ 下載安裝。 Postman 是最流行的 API 測試工具，第 6 章會完整教學： 匯入本教材附的測試集合、使用變數、撰寫自動化測試腳本。

選擇 IDE

  • IntelliJ IDEA（推薦）：Community 免費版即可開發 Spring Boot。 開啟專案時選擇 資料夾（含 的那層）， IDEA 會自動辨識為 Maven 專案並下載相依套件。

  • VS Code：安裝兩個延伸模組—— 與 。

環境檢查清單

  • 顯示 17 或更新版本

  • 顯示 3.9 或更新版本

  • MySQL 正在執行，且知道 root 密碼

  • 成功印出訊息

  • Postman 可以開啟