Spring Boot 开发环境快速搭建：Java + Maven + IDEA 配置一步到位

定位：面向零基础入门开发者，解决环境配置卡壳问题，全程图文步骤 + 避坑指南，确保 10 分钟内搭好可运行的 Spring Boot 基础环境。

一、引言

新手入门 Spring Boot 最头疼的就是 “环境配置”：Java 版本选错导致项目启动失败、环境变量配不对提示 “不是内部命令”、Maven 仓库下载慢卡半天、IDEA 插件缺失无法创建项目…… 本文从 “工具安装→配置→项目实战” 全程拆解，每一步都附操作截图和避坑提示，跟着做就能顺利跑通第一个 Spring Boot 项目。

二、第一步：安装 JDK 并配置环境变量（关键！）

2.1 版本选择与下载

• 推荐版本：JDK 17（Spring Boot 3.x 最低要求，Oracle 长期支持版，兼容性最好），避免用 JDK 18+ 预览版或 JDK 8 以下旧版本。
• 下载地址：
  • OpenJDK：Adoptium 官网
  • Oracle JDK：Oracle 官网，Oracle 甲骨文中国 | 云应用和云平台

以Oracle为例，进入甲骨文中国网站后点击上方Java

2.2 安装步骤

双击安装包，全程 “下一步” 即可，重点注意：安装路径不要包含中文、空格或特殊字符（比如默认路径C:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotspot就没问题）。

2.3 环境变量配置（以Windows为例）

2.3.1 Windows 系统（以 Win11 为例）

1. 新建系统变量 JAVA_HOME：
   • 变量名：JAVA_HOME
2. 编辑系统变量 Path：
4. 验证配置：

打开 cmd 命令行，输入java -version和javac -version，若均显示 JDK 21 版本号，则配置成功。

选中Path→“编辑”→“新建”，添加%JAVA_HOME%\bin，并将其移到列表最上方。

变量值：粘贴 JDK 安装路径（比如C:\Program Files\Eclipse Adoptium\jdk-17.0.11.9-hotspot）。我这是已经创建过了不用在意。

打开环境变量配置：右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”。

2.4 避坑点

• 同时安装多个 JDK 时，需确保Path中目标 JDK 的bin路径在最前面，否则会优先识别旧版本。
• 不要把 JRE 当作 JDK 安装（JRE 缺少javac编译命令，无法开发项目）。
• Windows 系统配置后若验证失败，重启 cmd 再试（环境变量需重启终端生效）。

三、第二步：配置 Maven 加速依赖下载

3.1 Maven 下载与安装

• 下载地址：Maven 官网，选择 “Binary zip archive” 格式（无需安装，解压即用）。

安装步骤：将下载的 zip 包解压到无中文、无空格的路径（比如D:\Program Files\apache-maven-3.9.6）。

3.2 环境变量配置

3.2.1Windows 系统

1. 新建系统变量 MAVEN_HOME：
   • 变量名：MAVEN_HOME

验证配置：cmd 输入mvn -v，显示 Maven 版本号即成功。

编辑系统变量 Path：添加%MAVEN_HOME%\bin，移到列表上方。

变量值：粘贴 Maven 解压路径（比如D:\Program Files\apache-maven-3.9.6）。

3.3 核心优化：修改 settings.xml（加速下载 + 自定义仓库）

Maven 默认从中央仓库下载依赖，速度极慢，需配置阿里云镜像；同时自定义本地仓库路径，避免占用 C 盘空间。

1. 找到settings.xml文件：位于 Maven 解压路径的conf目录下（比如D:\Program Files\apache-maven-3.9.6\conf\settings.xml）。
2. 编辑配置（用记事本或 IDEA 打开）：
   • 配置本地仓库：在<settings>标签内添加<localRepository>D:\MavenRepository</localRepository>（路径自定义，避免中文）。
   • 配置阿里云镜像：在<mirrors>标签内添加阿里云镜像代码（替换默认镜像）。

完整配置代码：

<!-- 自定义本地仓库路径 --> <localRepository>D:\MavenRepository</localRepository> <!-- 阿里云镜像配置 --> <mirror> <id>alimaven</id> <name>aliyun maven</name> <url>https://maven.aliyun.com/repository/central/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors>

3.4 IDEA 关联 Maven（关键！）

后续用 IDEA 开发 Spring Boot 项目，需让 IDEA 识别本地配置的 Maven，避免默认配置下载慢。

1. 配置三项：
   • Maven home path：选择本地 Maven 解压路径。
   • User settings file：选择刚才修改的settings.xml文件（勾选 Override）。
   • Local repository：会自动识别settings.xml中配置的本地仓库路径，无需手动修改。
2. 点击 “Apply”→“OK” 保存。

打开 IDEA，进入设置：File → Settings（Windows）/ Preferences（macOS）→ Build, Execution, Deployment → Build Tools → Maven。

四、第三步：IDEA 配置 Spring Boot 开发环境

4.1 安装 Spring Boot 插件

• IDEA 2020 及以上版本自带 “Spring Boot Helper” 插件，无需手动安装；若缺失，需手动安装：
  • 打开 IDEA → Settings → Plugins → 搜索 “Spring Boot”→ 找到 “Spring Boot Helper”→ 点击 “Install”→ 重启 IDEA。

4.2 两种方式创建 Spring Boot 项目（推荐方式 1）

方式 1：通过 IDEA 内置 Spring Initializr（推荐，无需手动下载）

1. 打开 IDEA → New Project → 左侧选择 “Spring Initializr”→ 右侧配置：
   • Name：项目名称（比如springboot-demo）。
   • Location：项目保存路径（无中文、无空格）。
   • Language：选择 “Java”。
   • Type：选择 “Maven”。
2. 点击 “Next”，选择依赖：
   • 左侧选择 “Web”→ 勾选 “Spring Web”（最基础依赖，用于开发接口）。

点击 “Next”→ 确认项目名称和路径 → 点击 “Finish”，IDEA 会自动下载依赖并构建项目（首次构建需等待几分钟，取决于网络速度）。

其他依赖（如 MySQL、MyBatis-Plus）后续可按需添加，当前仅需 “Spring Web”。

Java：选择 “17”（与本地 JDK 版本一致）。

方式 2：官网生成项目包后导入 IDEA（网络差时备用）

1. 打开 Spring Initializr 官网：https://start.spring.io/。
2. 配置项目信息（与方式 1 一致）：Project → Maven，Language → Java，Spring Boot → 3.x 稳定版，Java → 17。
3. 勾选 “Spring Web” 依赖 → 点击 “Generate” 下载项目压缩包。
4. 解压压缩包 → 打开 IDEA → File → Open → 选择解压后的项目文件夹 → 等待 IDEA 加载完成。

4.3 项目结构解读（新手必看）

• 核心目录：
  • src/main/java/com/example/springbootdemo：Java 代码目录，其中SpringbootDemoApplication.java是项目启动类（带@SpringBootApplication注解）。
  • src/main/resources：资源目录，application.properties是配置文件（后续修改端口、数据源等）。

src/test/java：测试代码目录（用于单元测试）。

五、第四步：验证环境是否搭建成功

5.1 编写测试接口

在controller包下新建HelloController类，编写简单接口：

import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class HelloController { // 接口路径：/hello @GetMapping("/hello") public String hello() { return "Hello Spring Boot! 环境搭建成功！"; } }

在启动类同级包下新建controller包（比如com.example.springbootdemo.controller）。

5.2 运行项目

观察控制台日志，若出现Started SpringbootDemoApplication in x.xxx seconds (processors: 8, memory: 1024.0MB)，说明项目启动成功。

找到启动类SpringbootDemoApplication.java，点击类名左侧的绿色运行按钮（或右键→Run）。

5.3 访问测试

1. 打开浏览器，输入http://localhost:8080/hello（默认端口 8080）。

浏览器页面显示 “Hello Spring Boot! 环境搭建成功！”，即说明整个环境配置完成。

六、总结与扩展

本文从 JDK 安装、Maven 配置、IDEA 项目创建到接口测试，完成了 Spring Boot 开发环境的全流程搭建。核心关键是 “版本匹配（JDK 17+Spring Boot 3.x）”“环境变量配置正确”“Maven 镜像加速”，只要避开这些坑，新手也能快速上手。

后续扩展方向：

• 整合 MyBatis-Plus 操作数据库。
• 配置多环境（开发 / 测试 / 生产）。
• 集成 Redis 实现缓存。