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

安装 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-parentproject 并声明一个或多个 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. 通常,您的项目会声明一个或多个Starters的依赖项。 Spring Boot 提供了一个有用的 Gradle 插件,可用于简化依赖项声明和创建可执行 jar。

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-boot-cli-*-bin.zipspring-boot-cli-*-bin.tar.gz来自 Spring 软件存储库的文件。

下载后,请按照解压后的存档中的INSTALL.txt说明进行作。 总之,有一个spring脚本 (spring.batfor Windows)bin/目录中的.zip文件。 或者,您可以使用java -jar使用.jar文件(该脚本可帮助您确保 Classpath 设置正确)。

使用 SDKMAN 安装!

开发人!(软件开发工具包管理器)可用于管理各种二进制 SDK 的多个版本,包括 Groovy 和 Spring Boot CLI。 获取 SDKMAN!sdkman.io 并使用以下命令安装 Spring Boot:

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

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

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

上述说明安装spring称为dev实例。 它指向您的目标构建位置,因此每次您重新构建 Spring Boot 时,spring是最新的。

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

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.5.0-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 包括为 BASHzsh shell 提供命令完成的脚本。 您可以source名为spring (_springfor zsh)或将其放在您个人或系统范围的 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

独家安装次数spring~/scoop/apps/springboot/current/bin.

如果您没有看到应用程序清单,则您的 scoop 安装可能已过期。 在这种情况下,请运行scoop update然后重试。

APP信息