跳到主要内容

安装 Spring Boot

DeepSeek V3 中英对照 Installing Spring Boot

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

$ java -version
shell

如果你刚接触 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-parent 项目，并声明对一个或多个 starters 的依赖。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 来声明。通常情况下，你的项目会声明对一个或多个启动器的依赖。Spring Boot 提供了一个实用的 Gradle 插件，可以用来简化依赖声明并创建可执行的 jar 文件。

Gradle Wrapper

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 应用，但它是快速启动 Spring 应用程序而无需 IDE 的一种便捷方式。

手动安装​

你可以从以下任一位置下载 Spring CLI 发行版：

下载完成后，请按照解压后的存档中的 INSTALL.txt 说明进行操作。简而言之，.zip 文件中的 bin/ 目录下有一个 spring 脚本（Windows 下为 spring.bat）。或者，你也可以使用 java -jar 命令直接运行 .jar 文件（该脚本帮助你确保类路径设置正确）。

使用 SDKMAN! 安装​

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

$ sdk install springboot
$ spring --version
Spring CLI v3.4.2
shell

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

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-3.4.2-bin/spring-3.4.2/
$ sdk default springboot dev
$ spring --version
Spring CLI v3.4.2
shell

前面的指令会安装一个名为 dev 的本地 spring 实例。它指向你的目标构建位置，因此每次重新构建 Spring Boot 时，spring 都会保持最新状态。

你可以通过运行以下命令查看：

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.4.2

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

OSX Homebrew 安装​

如果你在 Mac 上使用 Homebrew，可以通过以下命令安装 Spring Boot CLI：

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

Homebrew 将 spring 安装到 /usr/local/bin 目录下。

备注

如果您没有看到公式，可能是因为您安装的 brew 版本过旧。在这种情况下，请运行 brew update 并再次尝试。

MacPorts 安装​

如果你在 Mac 上使用 MacPorts，你可以通过以下命令安装 Spring Boot CLI：

$ sudo port install spring-boot-cli
shell

命令行补全​

Spring Boot CLI 包含了为 BASH 和 zsh shell 提供命令补全的脚本。你可以通过 source 命令来加载名为 spring 的脚本（对于 zsh 是 _spring），或者将其放入个人或系统级的 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
shell
备注

如果您使用 Homebrew 或 MacPorts 安装 Spring Boot CLI，命令行补全脚本将自动注册到您的 shell 中。

Windows Scoop 安装​

如果你在 Windows 上使用 Scoop，你可以通过以下命令安装 Spring Boot CLI：

$ scoop bucket add extras
$ scoop install springboot
shell

Scoop 将 spring 安装到 ~/scoop/apps/springboot/current/bin。

备注

如果看不到应用程序清单，可能是因为您的 scoop 安装版本过旧。在这种情况下，请运行 scoop update 并重试。