2.2 环境搭建与项目初始化

2.2 环境搭建与项目初始化

本节摘要：搭好 Java 环境、初始化 Spring Boot 项目、跑起第一个应用。本节给出环境清单（JDK、Maven）、初始化方式（官网生成器/IDE）、项目结构解读，以及"第一个 Hello World 接口"。

本节地图

阅读完本节，你应当能够：

1. 安装 JDK 与构建工具
2. 初始化 Spring Boot 项目
3. 看懂项目结构
4. 跑起第一个应用
5. 验证第一个接口

一、问题与直觉

"Spring Boot 项目从哪来？"——不用手搭，官方提供项目生成器（Spring Initializr）：勾选依赖，一键生成项目骨架。从"零"到"跑起来"只需三步：生成项目、导入 IDE、运行。

二、核心原理

项目初始化是一条清晰流水线：

2.1 环境清单

2.2 项目结构

src/main/java/  业务代码
src/main/resources/  配置文件
pom.xml  依赖清单
​

三、工程实践要点

3.1 三步跑起项目

第一步 生成：Spring Initializr 选依赖生成
第二步 导入：IDE 打开项目
第三步 运行：启动主类，访问 localhost:8080
​

3.2 第一个接口

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}
​

💡 关键直觉：@RestController + @GetMapping = 一个接口——注解声明"这是个接口 + 处理 GET 请求"。三个注解跑起第一个接口，这就是 Spring Boot 的"快"。

3.3 版本匹配提醒

JDK 版本 ↔ Spring Boot 版本 要匹配
依赖版本 ↔ 框架版本 要匹配
报错先看版本，再查依赖
​

⚠️ 常见坑：JDK 与框架版本不匹配。Spring Boot 3.x 需 JDK 17+，老 JDK 跑新框架必报错——初始化时选对版本组合。

要点串联

• 要点一：环境三件——JDK、Maven、IDE
• 要点二：项目用生成器一键初始化
• 要点三：三步跑起——生成、导入、运行
• 要点四：三个注解 = 第一个接口
• 要点五：版本匹配是环境第一坑
• 要点六：跑起来才有感觉

跑起来了，下一节拆内部——核心组件与注解。

常见疑问

Q1：JDK、JRE、Java 有什么区别？

简单说：JDK 是 Java 开发工具包（包含编译器、调试工具等，开发用）；JRE 是运行环境（只用来跑 Java 程序）；我们日常说的"装 Java"通常指 JDK（JDK 里自带 JRE）。对开发者来说装 JDK 就够了。版本上注意：Spring Boot 3 要求 JDK 17 及以上，JDK 8 或 11 跑新版本会直接报错。

Q2：项目生成器（Spring Initializr）是什么？怎么用？

它是官方提供的网页工具，用来生成 Spring Boot 项目骨架。你在页面上选好构建工具（Maven/Gradle）、语言（Java）、Spring Boot 版本、需要的依赖（Web、Data JPA、Security 等），它打包一个 zip 给你下载，解压导入 IDE 就能跑。依赖勾选对项目至关重要——比如要做 Web 接口就必须勾 Spring Web，要连数据库就勾 Spring Data JPA，忘了勾后面补也行，但生成时一次选好更省事。

Q3：Maven 到底是干什么的？

Maven 是构建和依赖管理工具。它干两件事：一是按 pom.xml 里的依赖清单，从远程仓库下载你需要的库（并管理它们之间的版本兼容）；二是执行构建生命周期——编译、打包（生成可执行 JAR）。你看到的 mvn package 就是打包命令。pom.xml 就是项目的"依赖清单 + 构建配置"，团队协作时只要共享它，别人就能还原出一样的项目。

Q4：第一个 Hello World 接口，代码是怎么工作的？

核心就三件套：@RestController 声明这是一个"返回 JSON 数据的接口类"；@GetMapping("/hello") 声明这个方法处理 GET /hello 请求；方法的返回值就是响应体。启动主类后，内嵌的 Tomcat 会监听 8080 端口，当浏览器访问那个地址时，请求经过框架解析，匹配到你的方法，方法返回的字符串被包装成 HTTP 响应返回。三个注解加一个方法，就是完整的后端接口。

工程实践要点

动手建议：完整走一遍"生成项目 → 导入 IDE → 运行 → 访问接口"流程，中途如果报错，按这三步排查：第一，确认 JDK 版本和框架版本匹配；第二，确认 Maven 依赖下载成功（看日志有没有红字）；第三，确认启动类能正常运行、端口没被占用。跑通第一个接口后，再试着改一下返回的字符串和路径，体会改代码生效的过程——这是你亲手搭起的第一台后端服务。

实战演练：从生成到跑通

本节最重要的目标，是亲自走完"生成项目到跑通接口"的完整链路。请按下面的步骤操作，每一步都有明确的验收标准：

第一步，打开项目生成器页面，选好构建工具（Maven）、语言（Java）、Spring Boot 版本（选当前稳定版），依赖勾选 Spring Web，点击生成并下载。验收标准：得到一个能解压的项目压缩包。

第二步，把项目导入 IDE（推荐 IntelliJ IDEA 社区版或 VsCode 加 Java 插件）。耐心等 Maven 下载完所有依赖，这个过程中网络可能较慢，属正常现象。验收标准：项目结构树完整出现，没有红叉报错。

第三步，找到启动类（类名带 Application 后缀、上有启动注解的那个），右键运行。观察控制台：出现端口监听的日志，说明启动成功。验收标准：启动日志中出现 Tomcat started on port 字样，且没有异常堆栈。

第四步，复制本节"第一个接口"的代码，新建一个控制器类，保存后重启应用。打开浏览器访问对应的地址。验收标准：页面返回你写的那句问候语。

第五步，故意制造一个错误——比如把启动类移到错误的位置、或把接口路径改成非法字符，观察报错信息，然后修复它。验收标准：你能从报错里读出问题出在哪一层。

五步走完，你不仅跑通了第一个 Spring Boot 应用，还学会了从报错中定位问题。这个能力比"能跑"更重要——因为后面的开发，你会无数次面对报错。

一句话记忆

环境搭建不是玄学，就是"生成、导入、运行、访问"四步，每一步都有明确验收标准。跑通一次，你就完成了从"看别人用 Spring Boot"到"自己用 Spring Boot"的跨越。