安裝 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 作為 group id。通常，你的 Maven POM 檔案繼承自 spring-boot-starter-parent 專案，並宣告對一個或多個 starter 的依賴。Spring Boot 還提供了一個可選的 Maven 外掛來建立可執行的 jar 包。

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

Gradle 安裝

Spring Boot 與 Gradle 7.x (7.6.4 或更高版本) 或 8.x (8.4 或更高版本) 相容。如果你尚未安裝 Gradle，可以按照 gradle.org 上的說明進行操作。

Spring Boot 的依賴項可以使用 org.springframework.boot 作為 group 宣告。通常，你的專案宣告對一個或多個 starter 的依賴。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.4.5

如果你為 CLI 開發功能並想訪問你構建的版本，請使用以下命令

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

上述說明安裝了一個名為 dev 的 spring 本地例項。它指向你的目標構建位置，因此每次重新構建 Spring Boot 時，spring 都會是最新版本。

你可以透過執行以下命令檢視它

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.4.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 系統上，系統級的指令碼位於 <installation location>/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 並重試。