第 1 章：IDEA 创建 SpringBoot3.5.16 Maven 项目

第 1 章：IDEA 创建 SpringBoot3.5.16 Maven 项目

前置：环境全部就绪（JDK17 + Maven3.9.11 + IDEA 配置完成）

目标：使用 IDEA 新建 Maven 类型 SpringBoot3 项目，确认包名、版本正确，项目能正常启动，完成本章启动测试
两种创建方式：① IDEA 内置 Spring Initializr（推荐） ② start.spring.io 网页生成导入。我们用第一种。

1.1 新建项目

1. IDEA 首页 → New Project
2. 左侧选择 Spring Initializr
   • Service URL：默认 https://start.spring.io（不用改）
   • Group：com.zzs
   • Artifact：szyt
   • Name：szyt
   • Description：szyt project
   • Package name：com.zzs.szyt（重点！和你要求的包名保持一致）
   • Type：Maven（不要选 Gradle）
   • Packaging：Jar（后续打包部署用 jar）
   • Java：17
   • Spring Boot 版本：3.5.16（下拉找到这个版本，务必不要选错）

⚠️ 注意：3.x 版本，JDK 必须 17，不能 8

3. 选择依赖（本章先选最小基础依赖，后面章节逐步追加 MyBatis、Redis 等）
   本章先勾选这 3 个：

• Spring Web（web 必备，提供 Tomcat，写接口）
• Lombok（简化实体类，少写 get/set）
• Spring Boot DevTools（热部署，改代码自动重启，开发神器）

MySQL、MyBatis、Redis 我们后面章节单独引入，循序渐进，避免一次性依赖太多新手排查困难

4. 点击 Create
5. 选择项目存放路径：路径不要中文、不要空格，等待 IDEA 自动加载 Maven 依赖（右下角进度条）

如果依赖下载很慢：确认前面 settings.xml 阿里云镜像配置正确，耐心等第一次拉包

1.2 项目目录结构核对（重点）

展开项目，标准结构：

szyt
├── pom.xml
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── zzs
│   │   │           └── szyt
│   │   │               └── SzytApplication.java  // 启动类
│   │   └── resources
│   │       ├── static
│   │       ├── templates
│   │       └── application.properties  // 后面我们删掉，换成yml
│   └── test
│       └── java
│           └── com
│               └── zzs
│                   └── szyt
│                       └── SzytApplicationTests.java
└── .gitignore

1.2.1 替换配置文件（properties → application.yml）

1. 删除 application.properties

2. 在 resources 下新建文件：application.yml

   基础服务配置

   server:
   port: 8080 # 服务端口，后面不改，先用8080
   spring:
   application:
   name: szyt

1.2.2 查看启动类 SzytApplication.java

代码自动生成如下，不用修改：

package com.zzs.szyt;

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

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

@SpringBootApplication：启动注解，扫描当前包 com.zzs.szyt 及其子包下所有组件

1.2.3 pom.xml 核对版本

打开 pom.xml，确认核心信息：

• parent 版本：3.5.16

  org.springframework.boot spring-boot-starter-parent 3.5.16

• 依赖部分（和我们勾选的一致）

  org.springframework.boot spring-boot-starter-web org.projectlombok lombok true org.springframework.boot spring-boot-devtools runtime true org.springframework.boot spring-boot-starter-test test

如果版本不对，手动修改 parent 版本号，然后右上角刷新 Maven（刷新图标）重新拉取

1.3 IDEA 开启 Lombok 支持（必做，否则报找不到 getter/setter）

1. File → Settings → Build, Execution, Deployment → Compiler → Annotation Processors
2. 勾选：Enable annotation processing → Apply → OK

Lombok 不开启这个，后面写实体类直接报错

1.4 本章测试：启动项目

两种启动方式任选其一：

方式 1：直接点启动类 main 方法左侧 ▶️ 运行

方式 2：右上角启动配置，选择 SzytApplication 启动

✅ 启动成功标志（控制台日志）：

Started SzytApplication in X seconds

没有报错，端口 8080 启动成功。

简单验证接口（先写一个测试 Controller，测试 web 环境）

新建包：com.zzs.szyt.controller

新建类：TestController.java

package com.zzs.szyt.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/test")
public class TestController {

    @GetMapping("/hello")
    public String hello(){
        return "Hello SpringBoot3！szyt项目启动成功";
    }
}

保存，devtools 会自动热部署。

访问方式二选一：

1. 浏览器打开：http://localhost:8080/test/hello
2. Postman GET 请求这个地址

预期返回文本：Hello SpringBoot3！szyt项目启动成功

---

📌 本章验收清单

1. ✅ 包名正确 com.zzs.szyt
2. ✅ SpringBoot 版本 3.5.16，Maven 项目类型
3. ✅ 配置文件替换为 application.yml
4. ✅ Lombok 注解处理器开启
5. ✅ 项目正常启动无报错
6. ✅ 访问 /test/hello 返回预期内容