Spring Boot 开发环境搭建：Java + Maven + IDEA 配置指南

• 配置本地仓库：在 <settings> 标签内添加 <localRepository>D:\MavenRepository</localRepository>。
• 配置阿里云镜像：在 <mirrors> 标签内添加阿里云镜像代码。

完整配置示例：

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

2.4 IDEA 关联 Maven

后续用 IDEA 开发 Spring Boot 项目，需让 IDEA 识别本地配置的 Maven。

1. 打开 IDEA，进入设置：File → Settings → Build, Execution, Deployment → Build Tools → Maven。
2. 配置三项：
   • Maven home path：选择本地 Maven 解压路径。
   • User settings file：选择刚才修改的 settings.xml 文件（勾选 Override）。
   • Local repository：会自动识别 settings.xml 中配置的本地仓库路径。
3. 点击'Apply'→'OK'保存。

三、IDEA 配置 Spring Boot 开发环境

3.1 安装 Spring Boot 插件

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

3.2 创建 Spring Boot 项目

推荐使用 IDEA 内置的 Spring Initializr，无需手动下载压缩包。

1. 打开 IDEA → New Project → 左侧选择'Spring Initializr'→ 右侧配置：
   • Name：项目名称（如 springboot-demo）。
   • Location：项目保存路径（无中文、无空格）。
   • Language：选择'Java'。
   • Type：选择'Maven'。
   • Java：选择'17'（与本地 JDK 版本一致）。
2. 点击'Next'，选择依赖：
   • 左侧选择'Web'→ 勾选'Spring Web'（最基础依赖，用于开发接口）。
3. 点击'Finish'，IDEA 会自动下载依赖并构建项目（首次构建需等待几分钟）。

备选方案：若网络较差，可访问 Spring Initializr 官网 生成项目包后导入 IDEA。

3.3 项目结构解读

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

四、验证环境是否搭建成功

4.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! 环境搭建成功！";
    }
}

4.2 运行项目

找到启动类 SpringbootDemoApplication.java，点击类名左侧的绿色运行按钮（或右键→Run）。观察控制台日志，若出现 Started SpringbootDemoApplication in x.xxx seconds，说明项目启动成功。

4.3 访问测试

打开浏览器，输入 http://localhost:8080/hello（默认端口 8080）。浏览器页面显示'Hello Spring Boot! 环境搭建成功！'，即说明整个环境配置完成。

五、总结

本文从 JDK 安装、Maven 配置、IDEA 项目创建到接口测试，完成了 Spring Boot 开发环境的全流程搭建。核心关键是'版本匹配（JDK 17 + Spring Boot 3.x）'、'环境变量配置正确'以及'Maven 镜像加速'。只要避开这些坑，新手也能快速上手。后续可进一步探索整合 MyBatis-Plus、配置多环境或集成 Redis 等功能。