此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.4.0spring-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-parentproject 并声明一个或多个 Starter 的依赖项。 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.5 或更高版本)和 8.x 兼容。 如果您尚未安装 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 包装器

当您需要构建项目时,Gradle Wrapper 提供了一种 “获取” Gradle 的好方法。 它是一个小型脚本和库,您可以将其与代码一起提交,以引导构建过程。 有关详细信息,请参阅 docs.gradle.org/current/userguide/gradle_wrapper.htmlspring-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,但这是在没有 IDE 的情况下启动 Spring 应用程序的快速方法。spring-doc.cadn.net.cn

手动安装

您可以下载其中一个spring-boot-cli-*-bin.zipspring-boot-cli-*-bin.tar.gz来自 Spring 软件存储库的文件。spring-doc.cadn.net.cn

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

使用 SDKMAN 安装!

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

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

如果您为 CLI 开发功能并希望访问您构建的版本,请使用以下命令:spring-doc.cadn.net.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

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

您可以通过运行以下命令来查看它:spring-doc.cadn.net.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.cadn.net.cn

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

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

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

MacPorts 安装

如果您使用的是 Mac 并使用 MacPorts,则可以使用以下命令安装 Spring Boot CLI:spring-doc.cadn.net.cn

$ 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! 进行安装,要手动运行脚本,请使用以下命令: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

独家安装次数spring~/scoop/apps/springboot/current/bin.spring-doc.cadn.net.cn

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