安装 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 并重试。