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

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

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

$ java -version

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

面向 Java 开发人员的安装说明

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

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

Maven 安装

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

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

Spring Boot 依赖项使用组 ID。 通常，您的 Maven POM 文件继承自项目，并将依赖项声明给一个或多个Starters。 Spring Boot 还提供了一个可选的 Maven 插件来创建可执行 jar。org.springframework.bootspring-boot-starter-parentspring-doc.cn

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

Gradle 安装

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

Spring Boot 依赖项可以使用 . 通常，您的项目会声明一个或多个Starters的依赖项。 Spring Boot 提供了一个有用的 Gradle 插件，可用于简化依赖项声明和创建可执行 jar。org.springframework.bootgroupspring-doc.cn

Gradle 包装器

当您需要构建项目时，Gradle Wrapper 提供了一种 “获取” Gradle 的好方法。 它是一个小型脚本和库，您可以将其与代码一起提交，以引导构建过程。 有关详细信息，请参阅 docs.gradle.org/current/userguide/gradle_wrapper.html。spring-doc.cn

有关 Spring Boot 和 Gradle 入门的更多详细信息，请参阅 Gradle 插件参考指南的入门部分。spring-doc.cn

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

安装 Spring Boot CLI

Spring Boot CLI（命令行界面）是一个命令行工具，可用于快速使用 Spring 进行原型设计。spring-doc.cn

您不需要使用 CLI 来使用 Spring Boot，但这是在没有 IDE 的情况下启动 Spring 应用程序的快速方法。spring-doc.cn

手动安装

您可以从 Spring 软件存储库下载其中一个 or 文件。spring-boot-cli-*-bin.zipspring-boot-cli-*-bin.tar.gzspring-doc.cn

下载后，请按照解压后的存档中的INSTALL.txt说明进行操作。 总之，在文件的目录中有一个脚本（适用于 Windows）。 或者，您也可以使用该文件（该脚本可帮助您确保 Classpath 设置正确）。springspring.batbin/.zipjava -jar.jarspring-doc.cn

使用 SDKMAN 安装！

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

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

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

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

上述说明安装名为 instance 的本地实例。 它指向您的目标构建位置，因此每次重新构建 Spring Boot 时，它都是最新的。springdevspringspring-doc.cn

您可以通过运行以下命令来查看它：spring-doc.cn

$ sdk ls springboot

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

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

OSX Homebrew 安装

如果您使用的是 Mac 并使用 Homebrew，则可以使用以下命令安装 Spring Boot CLI：spring-doc.cn

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

Homebrew 安装到 。spring/usr/local/binspring-doc.cn

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

MacPorts 安装

如果您使用的是 Mac 并使用 MacPorts，则可以使用以下命令安装 Spring Boot CLI：spring-doc.cn

$ sudo port install spring-boot-cli

命令行补全

Spring Boot CLI 包括为 BASH 和 zsh shell 提供命令完成的脚本。 您可以将脚本命名为 （ for zsh） 或将其放在您个人或系统范围的 bash 完成初始化中。 在 Debian 系统上，系统范围的脚本都在其中，并且该目录中的所有脚本都会在新的 shell 启动时执行。 例如，如果已使用 SDKMAN！ 进行安装，要手动运行脚本，请使用以下命令：sourcespring_spring<installation location>/shell-completion/<bash|zsh>spring-doc.cn

$ . ~/.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：spring-doc.cn

$ scoop bucket add extras
$ scoop install springboot

Scoop 安装到 。spring~/scoop/apps/springboot/current/binspring-doc.cn

如果您没有看到应用程序清单，则您的 scoop 安装可能已过期。 在这种情况下，请运行并重试。scoop update
如果您没有看到公式，则您的 brew 安装可能已过期。 在这种情况下，请运行并重试。brew update
如果使用 Homebrew 或 MacPorts 安装 Spring Boot CLI，则命令行完成脚本会自动注册到 shell。
如果您没有看到应用程序清单，则您的 scoop 安装可能已过期。 在这种情况下，请运行并重试。scoop update