第 1 章：IDEA 全局配置 Maven + 新建 SpringBoot3 Maven 项目

目标：把 IDEA 绑定我们刚才装好的 Maven3.9.11，使用 Spring Initializr 创建项目，拉取依赖，保证项目能正常启动。

前置：JDK17、Maven3.9.11、settings.xml 阿里云镜像都配置完成。

1.1 IDEA 配置 Maven（全局配置，以后新建项目自动生效）

打开 IDEA，不要先新建项目，先进入全局设置：

Windows：File → Settings（快捷键 Ctrl+Alt+S）

⚠️ 注意：如果已经打开了一个项目，这里是项目级设置；想要全局：File → Close Project，在欢迎页点右下角 Customize → All settings

找到 Build, Execution, Deployment → Build Tools → Maven
按下面填写：

Maven home path ：选择我们解压的 maven 目录 D:\maven\apache-maven-3.9.11
Settings file ：勾选 Override，选中 D:\maven\apache-maven-3.9.11\conf\settings.xml
Local repository ：会自动读取 settings.xml 里配置的 D:\maven\repository，核对一下路径正确

不要用 IDEA 自带的 bundled maven！必须选自己装的 3.9.11

展开 Maven → Importing

Import Maven projects automatically ✅ 勾选（自动导入依赖）
JDK for importer：选择 JDK17

展开 Maven → Runner

JRE：选择 JDK17
点击 Apply → OK，保存配置。

1.2 创建 SpringBoot3 项目

回到 IDEA 欢迎页，点击 New Project

左侧选择 Spring Initializr

Service URL：默认 https://start.spring.io（国内下载慢可以换成阿里云 https://start.aliyun.com，推荐阿里云）
Spring Boot 版本 ：选 3.3.x（3 最新稳定版，不要选带 M、SNAPSHOT 的预览版）
Group：com.demo（组织包名，反向域名）
Artifact：springboot-mp-demo（项目名，小写，横杠分隔）
Name：springboot-mp-demo
Description：SpringBoot3 + MyBatisPlus Demo
Package name：com.demo.springbootmpdemo（自动生成）
Packaging ：Jar（我们最后打包成 jar 部署）
Java ：17 ✅
点击 Next

勾选依赖（这一步只勾选基础依赖，后面 MyBatis-Plus、Redis 我们手动在 pom 引入，可控性更强）
✅ 勾选：

Spring Web（web 开发，提供接口）
Spring Boot DevTools（热部署，改代码不用反复重启）

先不勾选 MySQL、Redis，后面自己引入，方便理解 pom

点击 Next → Finish，选择项目存放路径（路径不要中文、空格），等待 IDEA 加载 Maven。

等待加载说明

右下角会弹出 Maven 进度条，第一次会下载大量 jar 包，因为阿里云镜像，速度会快很多。

如果卡住：右键项目 → Maven → Reload Project（刷新 maven）

1.3 查看项目初始目录结构

复制代码

springboot-mp-demo
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com/demo/springbootmpdemo
│   │   │       └── SpringbootMpDemoApplication.java  // 启动类
│   │   └── resources
│   │       ├── static
│   │       ├── templates
│   │       └── application.properties  // 默认配置文件
│   └── test
└── pom.xml  // maven核心依赖文件

第一步改造配置文件（重点）

我们后面统一用 yml 格式，删除 application.properties，新建 application.yml

路径：src/main/resources/application.yml

复制代码

# 服务端口
server:
  port: 8080
# 日志级别
logging:
  level:
    root: info

1.4 启动项目，第一次测试

打开启动类 SpringbootMpDemoApplication.java

复制代码

package com.demo.springbootmpdemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringbootMpDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringbootMpDemoApplication.class, args);
    }
}

点击类左侧绿色三角 ▶️，运行启动类。

✅ 成功标志

控制台最后输出：

复制代码

Started SpringbootMpDemoApplication in X seconds

打开浏览器访问：http://localhost:8080

页面显示 Whitelabel Error Page 是正常的！因为我们还没有写接口，只是代表服务成功跑起来了。

❌ 常见失败点排查

提示 JDK 版本不对：检查 Maven 导入器、项目 SDK、启动运行配置全部选 JDK17
Maven 一直红、依赖找不到：检查 settings.xml 镜像，重新 Reload Maven
端口 8080 被占用：yml 里改 server.port 为 8081 再启动

🧪 本章测试任务

确认 Maven 配置在 IDEA 里指向自己安装的 3.9.11
项目创建完成，依赖全部加载完毕（pom 无红色报错）
启动项目，控制台正常启动，访问 http://localhost:8080 出现错误页面