此版本仍在开发中，尚未被视为稳定版本。如需最新稳定版本，请使用 Spring Boot 4.0.4!spring-doc.cadn.net.cn

安装 Spring Boot

Spring Boot 可与“经典” Java 开发工具配合使用，也可作为命令行工具进行安装。无论采用哪种方式，您都需要 Java SDK 17 版本或更高版本。开始之前，请使用以下命令检查当前的 Java 安装情况：spring-doc.cadn.net.cn

$ java -version

如果您是 Java 开发的新手，或者想尝试 Spring Boot，建议您首先试用 Spring Boot CLI（命令行接口）。否则，请继续阅读“经典”安装说明。spring-doc.cadn.net.cn

Java 开发人员安装说明

您可以像使用任何标准 Java 库一样使用 Spring Boot。为此，请将适当的 spring-boot-*.jar 文件添加到您的类路径中。 Spring Boot 不需要任何特殊的工具集成，因此您可以使用任意 IDE 或文本编辑器。此外，Spring Boot 应用程序并无特殊之处，因此您可以像运行和调试其他 Java 程序一样运行和调试 Spring Boot 应用程序。spring-doc.cadn.net.cn

尽管你可以直接复制 Spring Boot 的 JAR 文件，但我们通常建议你使用支持依赖管理的构建工具（例如 Maven 或 Gradle）。spring-doc.cadn.net.cn

Maven 安装

Spring Boot 与 Apache Maven 3.6.3 或更高版本兼容。如果您尚未安装 Maven，可参考 maven.apache.org 上的安装说明。spring-doc.cadn.net.cn

在许多操作系统上，可以使用软件包管理器安装 Maven。如果您使用 macOS 的 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 项目，并声明对一个或多个Starters（Starters）的依赖。 Spring Boot 还提供了一个可选的Maven 插件，用于创建可执行的 JAR 文件。spring-doc.cadn.net.cn

有关使用 Spring Boot 和 Maven 快速上手的更多详细信息，请参阅 Maven 插件参考指南中的快速上手章节。spring-doc.cadn.net.cn

Gradle 安装

Spring Boot 兼容 Gradle 7.x（7.6.4 或更高版本）或 8.x（8.4 或更高版本）。如果您尚未安装 Gradle，可参考 gradle.org 上的安装说明。spring-doc.cadn.net.cn

可通过使用 org.springframework.boot group 声明 Spring Boot 依赖项。通常，您的项目会声明对一个或多个Starters（Starters）的依赖。 Spring Boot 提供了一个实用的Gradle 插件，可用于简化依赖项声明并创建可执行的 JAR 文件。spring-doc.cadn.net.cn

Gradle Wrapper

Gradle Wrapper 提供了一种便捷的方式来“获取”构建项目所需的 Gradle。它是一个小型脚本和库，可随您的代码一同提交，用于引导构建流程。详情请参阅 docs.gradle.org/current/userguide/gradle_wrapper.html。spring-doc.cadn.net.cn

有关使用 Spring Boot 和 Gradle 入门的更多详细信息，请参阅 Gradle 插件参考指南中的入门章节。spring-doc.cadn.net.cn

安装 Spring Boot CLI

Spring Boot CLI（命令行接口）是一个命令行工具，可用于快速使用 Spring 进行原型开发。spring-doc.cadn.net.cn

您无需使用命令行接口（CLI）来开发 Spring Boot 应用，但 CLI 是一种无需集成开发环境（IDE）即可快速启动 Spring 应用的便捷方式。spring-doc.cadn.net.cn

手动安装

您可以从 Spring软件仓库下载 spring-boot-cli-*-bin.zip 或 spring-boot-cli-*-bin.tar.gz 文件之一。spring-doc.cadn.net.cn

下载完成后，请遵循解压后归档文件中的 INSTALL.txt 文件说明进行安装。简而言之，在 .zip 文件的 bin/ 目录中，有一个 spring 脚本（Windows 系统下为 spring.bat 脚本）。或者，您也可以使用 java -jar 并配合 .jar 文件（该脚本可帮助您确认类路径已正确设置）。spring-doc.cadn.net.cn

使用 SDKMAN! 进行安装

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

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

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

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

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

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

$ sdk ls springboot

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

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

OS X Homebrew 安装

如果你使用的是 Mac 并安装了 Homebrew，则可以通过以下命令安装 Spring Boot CLI：spring-doc.cadn.net.cn

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

Homebrew 将安装 spring 到 /usr/local/bin。spring-doc.cadn.net.cn

如果未显示公式，则您的 Homebrew 安装可能已过时。此时，请运行 brew update，然后重试。

MacPorts 安装

如果你使用的是 Mac 并安装了 MacPorts，则可以通过以下命令安装 Spring Boot CLI：spring-doc.cadn.net.cn

$ sudo port install spring-boot-cli

命令行补全

Spring Boot CLI 包含为 BASH 和 zsh Shell 提供命令补全功能的脚本。您可以将名为 source 的脚本（zsh 对应的脚本为 spring，即 _spring）进行 source 操作，或将其放入您个人或系统级的 bash 补全初始化配置中。在 Debian 系统上，系统级脚本位于 <installation location>/shell-completion/<bash|zsh> 目录下，每当新 Shell 启动时，该目录中的所有脚本都会被执行。例如，若您通过 SDKMAN! 安装了 Spring Boot CLI，则可使用以下命令手动运行该脚本：spring-doc.cadn.net.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.cadn.net.cn

$ scoop bucket add extras
$ scoop install springboot

Scoop 安装 spring 到 ~/scoop/apps/springboot/current/bin 个。spring-doc.cadn.net.cn

如果未看到应用清单，则您的 Scoop 安装可能已过时。此时，请运行 scoop update，然后重试。