零基础新手15分钟内可完成Spring Boot环境配置并启动应用：①JDK 17解压至纯英文路径（如D:\Java\jdk-17），用PowerShell设置JAVA_HOME和Path；②IDEA中优先选用内置Maven 3.9.6，或手动配置阿里云镜像；③创建项目时确保Project SDK选对JDK 17，勾选Spring Web依赖，启动后访问localhost:8080验证容器成功运行。
零基础新手想马上运行第一个Spring Boot“Hello World”接口，但卡在JDK装不上、Maven报错、IDEA找不到Java SDK这三步上——别反复重装，问题往往出在路径含中文、环境变量没生效、版本乱配这三处硬伤，按本教程顺序操作，15分钟内可完成全部配置并成功启动应用。
装JDK 17并让系统真正认出来
第一步：去清华镜像站下载 jdk-17_windows-x64_bin.zip（不是.exe安装版），解压到 【D:\Java\jdk-17】 这个纯英文无空格路径下——若解压到“我的文档”或“Program Files”里，后续IDEA绝对识别失败。
第二步：用管理员权限打开PowerShell，一次性执行这两行命令（复制粘贴即可）：
[System.Environment]::SetEnvironmentVariable("JAVA_HOME","D:\Java\jdk-17","Machine")
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine"); [System.Environment]::SetEnvironmentVariable("Path",$env:Path+";D:\Java\jdk-17\bin","Machine")
第三步：关闭当前PowerShell窗口，新开一个，输入 java -version ——必须看到输出 java version "17.0.x" 才算成功；如果提示“不是内部或外部命令”，说明前两步没生效，别往下走，先重启电脑再试。
配Maven 3.9.x并换阿里云加速源
方法一：直接用IDEA内置Maven（推荐新手）
启动IntelliJ IDEA → 新建项目 → 选“Spring Initializr” → 在右侧“Maven home directory”下拉框里选 Bundled (Maven 3.9.6) → 点击Create。这一步跳过所有手动配置，IDEA自动调用自带Maven，不依赖你本地是否装过。
方法二：手动装Maven（需长期维护多个项目）
下载apache-maven-3.9.6-bin.zip → 解压到 【D:\Maven】（路径不能有中文、空格、括号）→ 打开D:\Maven\conf\settings.xml → 在<mirrors></mirrors>标签内插入阿里云镜像配置（注意是插在两个标签之间，不是外面）：
<mirror><id>aliyunmaven</id><mirrorOf>central</mirrorOf><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
验证：打开CMD，输入 mvn -v，看到Maven 3.9.6和Java 17信息即成功。若报错“mvn不是命令”，说明没把D:\Maven\bin加进Path，回去补。
在IDEA里创建并跑通第一个Spring Boot项目
第一步：打开IDEA → New Project → 左侧选Spring Initializr → 右侧检查：Project SDK必须显示“17 (java version “17.0.x”)”，若为空白或报红，点击旁边的齿轮图标 → Add JDK → 选中D:\Java\jdk-17 → Apply。
第二步：填写项目元数据：
Group填 com.example
Artifact填 demo
Package name自动同步为 com.example.demo
Type选 Maven，Language选 Java，Spring Boot版本选 3.3.2（2026年最新稳定版）
第三步：勾选依赖 → 必须勾选 Spring Web（其他如Lombok、Spring Boot DevTools可选，但首次运行先不勾）→ 点击Next → 设置项目名和路径（路径仍要避开中文和空格，例如D:\projects\demo）→ Finish。
第四步：等待IDEA自动下载依赖（右下角会显示“Building ‘demo’…”）。等进度条消失、pom.xml里不再标红、且左侧项目结构中出现“Maven”节点，说明依赖已就绪。
第五步：打开src/main/java/com/example/demo/DemoApplication.java → 找到main方法 → 点击左侧绿色三角形 ▶ 启动 → 控制台出现“Tomcat started on port(s): 8080” → 打开浏览器访问 http://localhost:8080 → 页面显示Whitelabel Error Page是正常的，因为还没写接口；此时已证明Spring Boot容器启动成功。
