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

安装 Spring Boot

Spring Boot 可以与“经典”的 Java 开发工具一起使用，或者安装为命令行工具。 无论哪种方式，您都需要 Java SDK v17 或更高版本。 在开始之前，请通过以下命令检查当前的 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 可以通过包管理器安装。 如果使用的是 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-doc.cadn.net.cn

更多关于如何开始使用 Spring Boot 和 Maven 的详细信息，可以在 Maven 插件参考指南中的Getting Started 部分找到。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

Spring Boot 依赖可以通过使用 org.springframework.boot 的 group 来声明。 通常，你的项目会声明对一个或多个 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

The Spring Boot CLI（命令行界面）是您可以使用的一种命令行工具，可以快速进行基于 Spring 的原型设计。spring-doc.cadn.net.cn

您无需使用命令行界面（CLI）来处理Spring Boot，但这是一个快速方式，在没有集成开发环境（IDE）的情况下启动一个Spring应用。spring-doc.cadn.net.cn

手动安装

你可以从Spring 软件仓库下载其中一个 spring-boot-cli-*-bin.tar.gz 或 https://repo.spring.io/snapshot/org/springframework/boot/spring-boot-cli/3.5.13-SNAPSHOT/ 文件。spring-doc.cadn.net.cn

下载完成后，请按照解压后归档文件中的 INSTALL.txt 说明进行操作。 简而言之，该 spring 文件的 spring.bat 目录中包含一个 bin/ 脚本（Windows 系统下为 .zip）。 或者，您也可以直接对 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

上述指令安装了一个本地的 spring 实例，称为 dev 实例。 它指向你的目标构建位置，因此每次重新构建 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
================================================================================

OSX Homebrew Installation

如果你使用的是 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 名为 spring 的脚本（对于 zsh 则是 _spring），或者将其放入个人或系统级的 bash 自动补全初始化目录中。 在 Debian 系统上，系统级脚本位于 <installation location>/shell-completion/<bash|zsh> 目录下，并且该目录中的所有脚本都会在新 shell 启动时被执行。 例如，如果你是通过 SDKMAN! 安装的，要手动运行该脚本，请使用以下命令：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后再试一次。