《SpringBoot 开发环境 “一键通关”：JDK+Maven+IDEA 超详细配置指南》-优快云博客

SpringBoot 的运行依赖JDK 版本匹配+Maven 依赖管理+IDEA 工具支持，配置错一个环节，后续要么 “项目起不来”，要么 “依赖下不全”—— 这篇直接帮你避掉 90% 的环境坑！

SpringBoot 2.x 推荐 JDK8/11，3.x 推荐 JDK17，这里选最常用的JDK1.8：

下载 JDK
- 官网地址：Oracle JDK8 下载页（注意选对应系统版本，比如 Windows 64 位）
- （配图：官网下载界面截图，标注 “Accept License Agreement”+ 对应安装包）
安装 JDK
- 双击安装包，选择安装路径（建议不要选 C 盘，比如D:\Java\jdk1.8.0_202）
- （配图：安装路径选择界面，标注 “更改” 按钮）
配置环境变量（关键！）
- 右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”
- 新建系统变量 JAVA_HOME：值填 JDK 安装路径（如D:\Java\jdk1.8.0_202）（配图：环境变量界面，标注 “新建”+JAVA_HOME 的填写）
- 编辑系统变量 Path：添加%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin（配图：Path 变量编辑界面，标注新增的两个路径）
- 验证是否成功：打开 cmd，输入java -version，出现 “java version "1.8.0_202"” 即成功（配图：cmd 运行结果截图）

Maven 是 SpringBoot 的依赖管理工具，默认镜像在国外，必须改国内源：

下载 Maven
- 官网地址：Apache Maven 下载页（选 “Binary zip archive”）
- （配图：官网下载界面，标注对应压缩包）
解压 + 配置环境变量
- 解压到非 C 盘路径（如D:\Maven\apache-maven-3.8.6）
- 新建系统变量 MAVEN_HOME：值填解压路径
- 编辑 Path：添加%MAVEN_HOME%\bin
- 验证：cmd 输入mvn -v，出现 Maven 版本信息即成功（配图：cmd 运行结果截图）
配置国内镜像（阿里云）+ 本地仓库
- 打开 Maven 解压路径下的conf\settings.xml
- 设置本地仓库：在<settings>标签内添加：
  xml
```
<localRepository>D:\Maven\repo</localRepository>
```
  （配图：settings.xml 中 localRepository 的位置标注）
- 添加阿里云镜像：在<mirrors>标签内添加：
  xml
```
<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>
```
  （配图：settings.xml 中 mirrors 标签内的阿里云镜像配置）

用 IDEA 创建 SpringBoot 项目，必须先关联 JDK 和 Maven：

IDEA 的 JDK 配置
- 打开 IDEA→“File”→“Project Structure”→“SDKs”
- 点击 “+”→“JDK”，选择之前安装的 JDK 路径（如D:\Java\jdk1.8.0_202）（配图：Project Structure 界面，标注 JDK 添加步骤）
IDEA 的 Maven 配置
- “File”→“Settings”→搜索 “Maven”
- 依次修改：
  - Maven home path：选 Maven 解压路径
  - User settings file：选 Maven 的conf\settings.xml
  - Local repository：选 Maven 的本地仓库路径（配图：IDEA 中 Maven 配置界面，标注三个选项的修改）
- （重要）勾选 “Override” 确保配置生效
一键创建 SpringBoot 项目（验证环境）
- IDEA 中选 “New Project”→“Spring Initializr”
- 填写项目信息（Group、Artifact），选择 JDK 版本→“Next”
- 勾选 “Spring Web” 依赖→“Finish”（配图：Spring Initializr 界面，标注依赖选择）
- 等待 Maven 下载依赖，然后启动项目（运行Application类）
- 浏览器访问http://localhost:8080，出现 “Whitelabel Error Page”（说明项目已启动）（配图：浏览器访问结果截图）