Spring Boot 3 项目初始化

创建 Spring Boot 3 项目有多种方式，最常用的是使用 Spring Initializr。Spring Initializr 是一个 Web 应用，可以帮助我们快速生成 Spring Boot 项目模板。

本节将学习：Spring Initializr 使用、项目结构说明、核心依赖介绍，以及配置文件说明。

Spring Initializr 使用

Spring Initializr 网站

Spring Initializr 官方地址：

Web 界面：https://start.spring.io/
API 文档：https://start.spring.io/

使用步骤

配置选项：

Project：Maven 或 Gradle
Language：Java、Kotlin 或 Groovy
Spring Boot：选择版本（推荐 3.2.x）
Project Metadata：
- Group：com.example
- Artifact：demo
- Name：demo
- Package name：com.example.demo
- Packaging：Jar
- Java：21
Dependencies：添加需要的依赖

常用依赖

Web 开发：

Spring Web
Spring Boot DevTools

数据访问：

Spring Data JPA
MySQL Driver
MyBatis Plus

其他：

Lombok
Spring Boot Actuator

项目结构说明

标准项目结构

demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── demo/
│   │   │               └── DemoApplication.java
│   │   └── resources/
│   │       ├── application.properties
│   │       └── application.yml
│   └── test/
│       └── java/
│           └── com/
│               └── example/
│                   └── demo/
│                       └── DemoApplicationTests.java
├── pom.xml
└── README.md

目录说明

目录说明：

src/main/java：Java 源代码
src/main/resources：配置文件、静态资源
src/test/java：测试代码
pom.xml：Maven 项目配置

核心依赖介绍

Spring Boot Starter

核心 Starter：

spring-boot-starter：核心功能，自动配置支持
spring-boot-starter-web：Web 开发支持（Spring MVC、Tomcat）
spring-boot-starter-data-jpa：JPA 数据访问支持
spring-boot-starter-test：测试支持

pom.xml 示例

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
        <relativePath/>
    </parent>
    
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    
    <properties>
        <java.version>21</java.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

配置文件说明

application.properties vs application.yml

application.properties：

server.port=8080
spring.application.name=demo
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=password

application.yml：

server:
  port: 8080
spring:
  application:
    name: demo
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: password

推荐使用 YAML：更清晰，支持多环境配置

多环境配置

# application.yml
spring:
  profiles:
    active: dev

---
# application-dev.yml
server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb_dev

---
# application-prod.yml
server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://prod-server:3306/mydb_prod

使用 IntelliJ IDEA 创建项目

创建步骤

File → New → Project
选择 Spring Initializr
配置项目信息
选择依赖
完成创建

项目配置

在 IntelliJ IDEA 中配置：

Project SDK：Java 21
Project language level：21
Maven 配置：使用系统 Maven 或项目 Maven

官方资源

Spring Initializr：https://start.spring.io/
Spring Boot 文档：https://docs.spring.io/spring-boot/docs/current/reference/html/
Spring Boot 示例：https://github.com/spring-projects/spring-boot/tree/main/spring-boot-samples

本节小结

在本节中，我们学习了：

第一个是 Spring Initializr 使用。 通过 Web 界面快速生成 Spring Boot 项目。

第二个是项目结构说明。 了解了标准 Spring Boot 项目的目录结构。

第三个是核心依赖介绍。 了解了常用的 Spring Boot Starter 依赖。

第四个是配置文件说明。 了解了 application.properties 和 application.yml 的使用。

这就是 Spring Boot 3 项目初始化。完成项目初始化后，我们就可以开始编写代码了。

在下一节，我们将学习 Spring Boot 3 的核心注解，了解如何使用这些注解构建应用。