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

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

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

$ java -version

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

Java 开发人员的安装说明

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

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

Maven 安装

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

在许多操作系统上,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-parentSpring中文文档

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

Gradle 安装

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

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

Gradle 包装器

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

有关 Spring Boot 和 Gradle 入门的更多详细信息,请参阅 Gradle 插件参考指南的入门部分Spring中文文档

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

安装 Spring Boot CLI

Spring Boot CLI(命令行界面)是一个命令行工具,可用于快速构建 Spring 原型。Spring中文文档

您不需要使用 CLI 来使用 Spring Boot,但它是一种无需 IDE 即可启动 Spring 应用程序的快速方法。Spring中文文档

手动安装

您可以从以下位置之一下载 Spring CLI 发行版:Spring中文文档

下载后,按照解压缩存档中的INSTALL.txt说明进行操作。 总之,文件目录中有一个脚本(适用于 Windows)。 或者,您可以与文件一起使用(该脚本可帮助您确保正确设置类路径)。springspring.batbin/.zipjava -jar.jarSpring中文文档

使用 SDKMAN 安装!

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

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

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

$ 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 时,都是最新的。springdevspringSpring中文文档

您可以通过运行以下命令来查看它:Spring中文文档

$ sdk ls springboot

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

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

OSX Homebrew 安装

如果您使用的是 Mac 并使用 Homebrew,则可以使用以下命令安装 Spring Boot CLI:Spring中文文档

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

Homebrew 安装到 .spring/usr/local/binSpring中文文档

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

MacPorts 安装

如果您使用的是 Mac 并使用 MacPorts,则可以使用以下命令安装 Spring Boot CLI:Spring中文文档

$ sudo port install spring-boot-cli

命令行完成

Spring Boot CLI 包括为 BASHzsh shell 提供命令补全的脚本。 您可以在任何 shell 中将脚本(也称为 )或将其放在您的个人或系统范围的 bash 完成初始化中。 在 Debian 系统上,系统范围的脚本都在 in 中,并且当新的 shell 启动时,该目录中的所有脚本都会被执行。 例如,如果已使用 SDKMAN! 进行安装,则要手动运行脚本,请使用以下命令:sourcespring<installation location>/shell-completion/bashSpring中文文档

$ . ~/.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:Spring中文文档

$ scoop bucket add extras
$ scoop install springboot

Scoop 安装到 .spring~/scoop/apps/springboot/current/binSpring中文文档

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