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

安装 Spring Boot

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.5 或更高版本)和 8.x 兼容。 如果您尚未安装 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.htmlspring-doc.cn

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

安装 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.3.7-SNAPSHOT

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

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

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

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

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.3.7-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 包括为 BASHzsh 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