安裝 Spring Boot

Spring Boot 可以與「傳統」Java 開發工具一起使用，或安裝為命令列工具。無論哪種方式，您都需要 Java SDK v17 或更高版本。在您開始之前，您應該使用以下命令檢查您目前的 Java 安裝

$ java -version

如果您是 Java 開發新手，或者您想試用 Spring Boot，您可能想先試試 Spring Boot CLI (命令列介面)。否則，請繼續閱讀「傳統」安裝說明。

Java 開發人員的安裝說明

您可以像使用任何標準 Java 程式庫一樣使用 Spring Boot。若要這麼做，請在您的類別路徑中包含適當的 spring-boot-*.jar 檔案。Spring Boot 不需要任何特殊的工具整合，因此您可以使用任何 IDE 或文字編輯器。此外，Spring Boot 應用程式沒有任何特殊之處，因此您可以像執行任何其他 Java 程式一樣執行和偵錯 Spring Boot 應用程式。

雖然您可以複製 Spring Boot jar 檔案，但我們通常建議您使用支援依賴管理 (例如 Maven 或 Gradle) 的建置工具。

Maven 安裝

Spring Boot 與 Apache Maven 3.6.3 或更高版本相容。如果您尚未安裝 Maven，您可以依照 maven.apache.org 上的指示進行安裝。

在許多作業系統上，可以使用套件管理器安裝 Maven。如果您使用 OSX Homebrew，請嘗試 brew install maven。Ubuntu 使用者可以執行 sudo apt-get install maven。使用 Chocolatey 的 Windows 使用者可以從提升權限 (管理員) 的命令提示字元執行 choco install maven。

Spring Boot 依賴使用 org.springframework.boot 群組 ID。通常，您的 Maven POM 檔案會繼承自 spring-boot-starter-parent 專案，並宣告對一或多個 starters 的依賴。Spring Boot 也提供一個選用的 Maven 外掛程式來建立可執行 jar 檔案。

有關 Spring Boot 和 Maven 入門的更多詳細資訊，請參閱 Maven 外掛程式參考指南的入門章節。

Gradle 安裝

Spring Boot 與 Gradle 7.x (7.5 或更高版本) 和 8.x 相容。如果您尚未安裝 Gradle，您可以依照 gradle.org 上的指示進行安裝。

可以使用 org.springframework.boot group 宣告 Spring Boot 依賴。通常，您的專案會宣告對一或多個 starters 的依賴。Spring Boot 提供一個有用的 Gradle 外掛程式，可用於簡化依賴宣告並建立可執行 jar 檔案。

Gradle Wrapper

Gradle Wrapper 提供一種在您需要建置專案時「取得」Gradle 的好方法。它是一個小型腳本和程式庫，您將其與程式碼一起提交，以引導建置程序。請參閱 docs.gradle.org/current/userguide/gradle_wrapper.html 以取得詳細資訊。

有關 Spring Boot 和 Gradle 入門的更多詳細資訊，請參閱 Gradle 外掛程式參考指南的入門章節。

安裝 Spring Boot CLI

Spring Boot CLI (命令列介面) 是一個命令列工具，您可以使用它快速建立 Spring 的原型。

您不需要使用 CLI 即可使用 Spring Boot，但這是無需 IDE 即可啟動 Spring 應用程式的快速方法。

手動安裝

您可以從以下位置之一下載 Spring CLI 發行版

下載後，依照解壓縮歸檔中的 INSTALL.txt 指示進行操作。總之，在 .zip 檔案的 bin/ 目錄中，有一個 spring 腳本 (Windows 為 spring.bat)。或者，您可以將 java -jar 與 .jar 檔案一起使用 (該腳本可協助您確保正確設定類別路徑)。

使用 SDKMAN! 安裝

SDKMAN! (軟體開發套件管理器) 可用於管理各種二進制 SDK 的多個版本，包括 Groovy 和 Spring Boot CLI。從 sdkman.io 取得 SDKMAN!，並使用以下命令安裝 Spring Boot

$ sdk install springboot
$ spring --version
Spring CLI v3.3.5

如果您為 CLI 開發功能並想要存取您建置的版本，請使用以下命令

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-3.3.5-bin/spring-3.3.5/
$ sdk default springboot dev
$ spring --version
Spring CLI v3.3.5

前面的指示會安裝 spring 的本機實例，稱為 dev 實例。它指向您的目標建置位置，因此每次您重建 Spring Boot 時，spring 都是最新的。

您可以執行以下命令來查看它

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.3.5

================================================================================
+ - local version
* - installed
> - currently in use
================================================================================

OSX Homebrew 安裝

如果您使用的是 Mac 且使用 Homebrew，則可以使用以下命令安裝 Spring Boot CLI

$ brew tap spring-io/tap
$ brew install spring-boot

Homebrew 會將 spring 安裝到 /usr/local/bin。

如果您沒有看到公式，則您的 brew 安裝可能已過時。在這種情況下，請執行 brew update 並重試。

MacPorts 安裝

如果您使用的是 Mac 且使用 MacPorts，則可以使用以下命令安裝 Spring Boot CLI

$ sudo port install spring-boot-cli

命令列完成

Spring Boot CLI 包含為 BASH 和 zsh shell 提供命令完成的腳本。您可以 source 名為 spring (zsh 為 _spring) 的腳本，或將其放在您的個人或系統範圍的 bash 完成初始化中。在 Debian 系統上，系統範圍的腳本位於 <安裝位置>/shell-completion/<bash|zsh> 中，並且在啟動新 shell 時會執行該目錄中的所有腳本。例如，如果您使用 SDKMAN! 安裝，若要手動執行腳本，請使用以下命令

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  encodepassword  help  init  shell  version

如果您使用 Homebrew 或 MacPorts 安裝 Spring Boot CLI，則命令列完成腳本會自動向您的 shell 註冊。

Windows Scoop 安裝

如果您使用的是 Windows 且使用 Scoop，則可以使用以下命令安裝 Spring Boot CLI

$ scoop bucket add extras
$ scoop install springboot

Scoop 會將 spring 安裝到 ~/scoop/apps/springboot/current/bin。

如果您沒有看到應用程式資訊清單，則您的 scoop 安裝可能已過時。在這種情況下，請執行 scoop update 並重試。