从环境到项目：Spring Boot框架安装全解析【实战演练】

必须配齐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），在 标签下插入阿里云镜像配置：

aliyunmavencentralAliyun Mavenhttps://maven.aliyun.com/repository/public

⚠️ 不改镜像源的话，首次创建项目时会卡在 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
public class IndexController {
  @GetMapping("/hello")
  public String hello() {
    return "Hello from Spring Boot 3.2!";
  }
}

找到项目根目录下的 DemoApplication.java，点击左侧绿色三角形 ▶️ 运行它。

控制台出现 "Tomcat started on port(s): 8080" 后，在浏览器访问 http://localhost:8080/hello，页面显示文本即代表整个环境链路打通。