必须配齐jdk 17+、maven 3.8.8+及ide三件套，jdk版本不匹配会启动失败，maven未配镜像源将卡在依赖下载，ide未识别项目结构则无法编译。
要在本地机器上跑起一个可调试、可运行的Spring Boot项目，必须先配齐JDK、Maven和IDE三件套，缺一不可——JDK版本不匹配会导致启动失败，Maven未配置好会卡在依赖下载环节，IDE未识别项目结构则根本无法编译。
安装并验证JDK（必须JDK 17+用于Spring Boot 3.x）
访问 https://adoptium.net/ 下载 Eclipse Temurin JDK 17 LTS 版本，安装后配置系统环境变量 JAVA_HOME 和 PATH。
打开终端执行 java -version，输出中必须包含 17. 开头的版本号；若显示 1.8 或 11，则 Spring Boot 3.x 项目将直接抛出 UnsupportedClassVersionError 异常。
这一步不能跳过，Spring Boot 3.0 起已彻底放弃对 JDK 8 的支持，用旧版 JDK 打开项目只会看到红色报错堆栈。
配置Maven并设为国内镜像源
从 https://maven.apache.org/download.cgi 下载 Maven 3.8.8+ 压缩包，解压后设置 MAVEN_HOME 环境变量，并将 %MAVEN_HOME%\bin（Windows）或 $MAVEN_HOME/bin（macOS/Linux）加入 PATH。
验证：终端执行 mvn -v，确认输出含 Apache Maven 3.8.x 及 Java version 17。
修改 ~/.m2/settings.xml（Windows 在 %USERPROFILE%\.m2\settings.xml），在 <mirrors></mirrors> 标签下插入阿里云镜像配置：
<mirror><id>aliyunmaven</id><mirrorof>central</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
⚠️ 不改镜像源的话，首次创建项目时会卡在 downloading spring-boot-starter-web-3.2.0.jar，等半小时都可能没反应。
用IDEA创建第一个Spring Boot项目
启动 IntelliJ IDEA Ultimate（Community 版需手动添加 Spring Boot 插件），点击 New Project → 左侧选 Spring Initializr → 右侧保持默认：
• Spring Boot Version: 3.2.0（确保与JDK 17兼容）
• Packaging: Jar
• Java Version: 17
• Dependencies: 勾选 Spring Web（其他先不选，避免干扰）
填写 Group（如 com.example）和 Artifact（如 demo），点击 Next → Finish。
IDEA 自动解析 pom.xml 后，右下角弹出 “Import changes” 提示，点击 Enable Auto-Import；等待右侧 Maven 面板中 Dependencies 展开且无红标即表示依赖拉取成功。
编写并运行首个接口
在 src/main/java/com/example/demo 下新建 package：controller，再新建类 IndexController.java：
@RestController<br>public class IndexController {<br> @GetMapping("/hello")<br> public String hello() {<br> return "Hello from Spring Boot 3.2!";<br> }<br>}
找到项目根目录下的 DemoApplication.java，点击左侧绿色三角形 ▶️ 运行它。
控制台出现 "Tomcat started on port(s): 8080" 后，在浏览器访问 http://localhost:8080/hello，页面显示文本即代表整个环境链路打通。
