安装 Spring Boot (Installing Spring Boot) _ Spring Boot3.3.2-SNAPSHOT中文文档(官方文档中文翻译)|Spring 教程 —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Boot 3.3.1！

Spring Boot 可以与“经典”Java 开发工具一起使用，也可以作为命令行工具安装。无论哪种方式，您都需要 Java SDK v17 或更高版本。在开始之前，应使用以下命令检查当前的 Java 安装：

$ java -version

如果您不熟悉 Java 开发，或者想要尝试 Spring Boot，您可能希望先尝试 Spring Boot CLI（命令行界面）。否则，请继续阅读“经典”安装说明。

Java 开发人员的安装说明

您可以像使用任何标准 Java 库一样使用 Spring Boot。为此，请在类路径中包含相应的文件。 Spring Boot 不需要任何特殊工具集成，因此您可以使用任何 IDE 或文本编辑器。此外，Spring Boot 应用程序没有什么特别之处，因此您可以像运行任何其他 Java 程序一样运行和调试 Spring Boot 应用程序。spring-boot-*.jar

虽然您可以复制 Spring Boot jar，但我们通常建议您使用支持依赖项管理的构建工具（例如 Maven 或 Gradle）。

Maven 安装

Spring Boot 与 Apache Maven 3.6.3 或更高版本兼容。如果您尚未安装 Maven，可以按照 maven.apache.org 中的说明进行操作。

在许多操作系统上，Maven 可以与包管理器一起安装。如果您使用 OSX Homebrew，请尝试。 Ubuntu 用户可以运行 . 使用 Chocolatey 的 Windows 用户可以从提升的（管理员）提示符运行。brew install mavensudo apt-get install mavenchoco install maven

Spring Boot 依赖项使用组 ID。通常，Maven POM 文件继承自项目，并声明对一个或多个“启动器”的依赖关系。 Spring Boot 还提供了一个可选的 Maven 插件来创建可执行的 jar。org.springframework.bootspring-boot-starter-parent

有关 Spring Boot 和 Maven 入门的更多详细信息，请参阅 Maven 插件参考指南的入门部分。

Gradle 安装

Spring Boot 与 Gradle 7.x（7.5 或更高版本）和 8.x 兼容。如果您尚未安装 Gradle，可以按照 gradle.org 中的说明进行操作。

Spring Boot 依赖项可以通过使用 . 通常，项目会声明对一个或多个“Starters”的依赖关系。 Spring Boot 提供了一个有用的 Gradle 插件，可用于简化依赖项声明和创建可执行 jar。org.springframework.bootgroup

Gradle 包装器

当您需要构建项目时，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说明进行操作。总之，文件目录中有一个脚本（适用于 Windows）。或者，您可以与文件一起使用（该脚本可帮助您确保正确设置类路径）。springspring.batbin/.zipjava -jar.jar

使用 SDKMAN 安装！

SDKMAN！（软件开发工具包管理器）可用于管理各种二进制 SDK 的多个版本，包括 Groovy 和 Spring Boot CLI。获取 SDKMAN！从 sdkman.io 并使用以下命令安装 Spring Boot：

$ sdk install springboot
$ spring --version
Spring CLI v3.3.2-SNAPSHOT

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

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

上述说明安装被调用的实例的本地实例。它指向您的目标构建位置，因此每次重新构建 Spring Boot 时，都是最新的。springdevspring

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

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.3.2-SNAPSHOT

================================================================================
+ - 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 提供命令补全的脚本。您可以在任何 shell 中将脚本（也称为）或将其放在您的个人或系统范围的 bash 完成初始化中。在 Debian 系统上，系统范围的脚本都在 in 中，并且当新的 shell 启动时，该目录中的所有脚本都会被执行。例如，如果已使用 SDKMAN！进行安装，则要手动运行脚本，请使用以下命令：sourcespring<installation location>/shell-completion/bash

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  grab  help  jar  run  test  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

如果您没有看到该公式，则您的 brew 安装可能已过期。在这种情况下，请运行并重试。brew update

如果使用 Homebrew 或 MacPorts 安装 Spring Boot CLI，则命令行完成脚本会自动注册到 shell。

如果未看到应用清单，则 scoop 安装可能已过期。在这种情况下，请运行并重试。scoop update