环境准备：JDK 与构建工具

需要准备的三样东西

开始之前，先认清要装什么：

• JDK 17 以上（推荐 21 LTS）
• 构建工具：Maven 或 Gradle（新手选 Maven）
• 一款 IDE：STS、IntelliJ IDEA 或 VS Code

版本要求：先看清基线

Spring Boot 4.1.0 的环境要求，官方写得很明确：

组件	要求
JDK	17 及以上，最高支持到 26
Maven	3.6.3 及以上
Gradle	8.14 及以上，或 9.x

为什么推荐 JDK 21？它是 LTS（长期支持）版本，企业用得最多，遇到问题好搜。装 17 也能跑，但 21 更省心。

安装 JDK

JDK 就是 Java 的开发工具包，装了它才能编译和运行 Java 程序。下载渠道很多，推荐 Eclipse Temurin（Adoptium 发行版），免费、无坑、更新及时。

按系统挑一种方式：

• Windows：下载 .msi 安装包，一路下一步，记住安装路径
• macOS：brew install --cask temurin@21
• Linux（Ubuntu/Debian）：sudo apt install openjdk-21-jdk

装完打开命令行，验证安装结果：

java -version

输出类似这样就算成功：

openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM (build 21.0.5+11-LTS, mixed mode, sharing)

Windows 用户还要配两个环境变量：

• JAVA_HOME：指向 JDK 安装目录，比如 C:\Program Files\Eclipse Adoptium\jdk-21.0.5
• Path：追加 %JAVA_HOME%\bin

验证配置：

echo %JAVA_HOME%

安装 Maven

Maven 是 Java 世界的「构建 + 依赖管理」工具。Spring Boot 靠它下载依赖、编译代码、打包运行。

为什么需要它？Java 项目要用几十上百个第三方库。手动下载、手动管理版本，项目迟早崩。Maven 用一份 pom.xml 声明依赖，自动下载、自动管理传递依赖。下载的依赖统一放在本地仓库，默认是用户目录下的 .m2/repository。

安装步骤：

1. 去 maven.apache.org 下载二进制 zip 包
2. 解压到固定目录，比如 D:\tools\apache-maven-3.9.x
3. 配置环境变量 MAVEN_HOME，指向解压目录
4. Path 里追加 %MAVEN_HOME%\bin

验证：

mvn -v

能看到 Maven 版本和它使用的 Java 版本，就说明装好了。

国内下载依赖慢？改 Maven 的 settings.xml，加阿里云镜像，速度立竿见影：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

settings.xml 在 Maven 安装目录的 conf 目录下，初学者替换 <mirrors> 标签内容即可。

先记下几个常用命令，后面每章都会用到：

命令	作用
mvn compile	编译源码
mvn test	跑测试
mvn package	打包成 jar
mvn clean	清理 target 目录
mvn spring-boot:run	直接运行应用

Gradle 是什么，什么时候选它

Gradle 是另一个构建工具，功能类似 Maven，但脚本更灵活、增量构建更快。Spring Boot 对它的要求是 8.14 及以上或 9.x。

新手选哪个？默认 Maven。理由很实在：教程多、资料多、公司里最常见。Gradle 的构建脚本（Groovy 或 Kotlin DSL）对零基础不友好。等 Maven 熟了，再学 Gradle 不迟。

本教程的构建命令默认用 Maven，需要 Gradle 的地方会单独点出来。

选一款 IDE

三个主流选择，按自己的情况挑：

Spring Tool Suite（STS）。Spring 官方出品的 Eclipse 定制版，自带 Spring 全套插件，开箱即用。下载地址 spring.io/tools。下载 zip 解压后，双击 SpringToolSuite4.exe 启动，选个工作目录即可。适合喜欢官方套件的同学。

IntelliJ IDEA。Java 开发者用得最多的 IDE。社区版免费，功能足够学完本教程；旗舰版有 Spring 专属支持，但收费。官方文档里大量截图基于 IDEA，跟着学最顺。

VS Code。轻量，装 Java 扩展包和 Spring Boot 扩展也能开发。适合机器配置一般、不想装重型 IDE 的同学。

装 STS 首次启动要选 workspace 目录，随便建个英文路径的文件夹即可，比如 D:\workspace。

IDE	上手难度	费用	适合谁
STS	低	免费	喜欢官方套件
IntelliJ IDEA	低	社区版免费	多数人，主流选择
VS Code	中	免费	轻量开发

不管选哪个，导入 Maven 项目都是标配能力。IDEA 直接打开项目根目录的 pom.xml；STS 用 File → Import → Existing Maven Projects。

不用 IDE 行不行

行。Spring Boot 应用本质是普通 Java 程序，文本编辑器 + 命令行也能开发。官方文档明确说：不需要任何特殊 IDE 插件，任意编辑器都能写。

但新手还是建议用 IDE。代码补全、报错提示、一键运行，能省掉大量查错时间。等你对项目结构熟了，再回到命令行也不迟。

工具链就位后，最重要的能力是看懂报错。报错不可怕，先读第一行异常类型，再搜最后一行原因，九成问题在这两步里。

多版本 JDK 共存

开发机器上经常装了好几个 JDK。IDEA 里可以给每个项目单独指定：Project Structure → Project SDK，下拉框里选版本。命令行则看 JAVA_HOME 指到哪个，mvn -v 输出的就是当前生效的版本。

想临时切换，在命令行里改：

set JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-17.0.10
mvn -v

切回 21 就把路径换回去。原则就一条：项目的 SDK 设置优先于系统环境变量。IDE 里报版本错误，先查项目设置，再查环境变量。

环境自检清单

自检原则一句话：版本号能打出来，工具就能用；打不出来，先查环境变量。

装完别急着写代码，先跑一遍：

java -version
mvn -v

两条命令都能输出版本号，环境就绪。IDE 里新建项目时，记得把 Project SDK 指到刚才装的 JDK 21，别让它默认用别的版本。

常见坑

• 版本对不上：mvn -v 里显示的 Java 不是 17+，说明 JAVA_HOME 指错了
• 环境变量改了不生效：重开命令行，或重启 IDE
• 依赖下载极慢：先配阿里云镜像，再谈其它
• IDE 报 JDK 错误：检查 Project Structure 里的 SDK 设置
• JDK 装错架构：Windows 选 x64 版，苹果电脑注意 arm64 与 x64 的区别，装错可能闪退
• 杀毒软件拦截：Maven 首次下载依赖时可能被拦截，放行即可

环境备齐，下一章创建第一个 Spring Boot 应用。

小结

本章装好了 JDK 17+、Maven 和 IDE。环境问题九成是版本或路径问题，报错信息里通常直接写了答案，先读报错，再上网搜。