安装 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 项目，并声明对一个或多个 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.6

如果您为 CLI 开发功能并希望访问您构建的版本，请使用以下命令：

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

上述说明会安装一个名为 dev 的本地 spring 实例。它指向您的目标构建位置，因此每次重新构建 Spring Boot 时，spring 都会保持最新。

您可以通过运行以下命令查看：

$ sdk ls springboot

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

================================================================================
+ - 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 并重试。