直接用spring initializr创建最省事，关键在于对齐jdk、maven、spring boot三版本：jdk 8配spring boot 2.7.x，jdk 17/21配3.2.x；推荐idea内置initializr（url换为https://start.aliyun.com）或官网生成后导入；项目启动后加hellocontroller类并访问http://localhost:8080/hello即可验证成功。
直接用 Spring Initializr 创建最省事，关键不是“快”，而是把 JDK、Maven、Spring Boot 版本这三者对齐——只要配对了，5 分钟内就能跑出 “Hello Spring Boot”。
一、环境准备：先确认三个版本能不能握手
别急着点 “新建项目”，先打开终端输入：
- java -version：看是 JDK 8（显示 1.8）、JDK 17 还是 JDK 21
- mvn -v：确认 Maven 已安装，版本建议 3.6+（3.9.9 更稳）
然后对照选 Spring Boot 版本：
- JDK 8 → 选 Spring Boot 2.7.x（长期维护版，兼容性好）
- JDK 17 或 21 → 直接选 Spring Boot 3.2.x（主流新版本，无 javax 包名迁移烦恼）
二、创建项目：推荐两种可靠方式
方式 1：IDEA 内置 Initializr（最顺滑）
- 打开 IDEA → New Project → 左侧选 Spring Initializr
- URL 改成国内镜像：https://start.aliyun.com（避免卡在下载依赖）
- 填 Group（如 com.example）、Artifact（项目名）、Java 版本、打包类型（Jar）
- 依赖只勾一个：Spring Web（够跑第一个接口）
方式 2：官网生成后导入（最可控）
- 访问 https://start.aliyun.com（比官方 start.spring.io 更快）
- 填好基本信息，加 Spring Web，点 “Generate” 下载 zip
- 解压 → IDEA 中选择 “Open” 导入该文件夹（不要选 “Import Project”）
三、跑通第一个接口：三步验证是否成功
项目导入后，按顺序做三件事：
- 找到 src/main/java 下的主启动类（名字类似 DemoApplication），右键 Run 启动
- 等控制台出现 Tomcat started on port(s): 8080，说明服务已就绪
- 新建一个类 HelloController.java，放在同级包下，内容如下：
@RestController
public class HelloController {
@RequestMapping("/hello")
public String hello() {
return "Hello Spring Boot!";
}
}
保存后刷新浏览器访问 http://localhost:8080/hello，看到文字就代表搭建完成。
四、几个容易卡住的细节提醒
- Maven 本地仓库路径最好手动指定（比如 D:/repository），避免默认在 C 盘导致权限或空间问题
- 如果 IDEA 右下角一直转圈下载依赖，检查 Settings → Build → Maven → 本地设置文件（setting.xml）是否指向你改过的仓库路径
- 报错 UnsupportedClassVersionError？一定是 JDK 和 Spring Boot 版本不匹配，回第一步核对
- 访问 /hello 返回 404？检查 HelloController 类是否在主启动类的包或子包下（Spring Boot 默认扫描同包及子包）
