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

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

3. 编辑系统变量 Path：
   • 选中 Path → '编辑' → '新建'，添加 %JAVA_HOME%\bin，并将其移到列表最上方。

4. 验证配置： 打开 cmd 命令行，输入 java -version 和 javac -version，若均显示对应版本号，则配置成功。

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.1 Windows 系统

1. 新建系统变量 MAVEN_HOME：
   • 变量名：MAVEN_HOME
   • 变量值：粘贴 Maven 解压路径（比如 D:\Program Files\apache-maven-3.9.6）。

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

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

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>

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 实现缓存。