IntelliJ IDEA 创建 Spring Boot 项目指南

修改 Maven 镜像仓库

如果 Maven 加载过慢，可将 settings.xml 中的镜像源替换为阿里云。

原配置：

<mirror>
    <id>maven-default-http-blocker</id>
    <mirrorOf>external:http:*</mirrorOf>
    <name>Pseudo repository to mirror external repositories initially using HTTP.</name>
    <url>http://0.0.0.0/</url>
    <blocked>true</blocked>
</mirror>

替换为新配置：

<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>*</mirrorOf>
</mirror>

接着重写用户设置文件和本地仓库的路径。

后续添加依赖时，可在 pom.xml 中点击 Add Starter 选择。

免费版 IDEA 创建教程

如果使用免费社区版 IDEA，可访问 start.spring.io 官网创建，步骤类似。

选择需要的依赖后点击 CREATE 按钮。

解压项目后用 IDEA 打开即可。

之后需修改 Maven 仓库等配置。

项目结构解析

生成的项目目录结构如下：

EngStudy
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.example.engstudy
│   │   │       └── engstudyApplication.java # 启动类
│   │   └── resources
│   │       ├── static # 静态资源（CSS/JS）
│   │       ├── templates # 模板文件（HTML）
│   │       └── application.properties # 配置文件
│   └── test # 测试代码
└── pom.xml # Maven 依赖管理

编写测试接口

创建 Controller

在 src/main/java/com.example.engstudy 下新建 HelloController.java。

package com.example.engstudy;

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

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello(@RequestParam(value = "name", defaultValue = "World") String name) {
        return "Hello " + name + "!";
    }
}

若不需要数据库，在 src/main/resources/application.properties 中添加配置禁用数据源自动配置：

spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

启动应用

打开启动类 EngStudyApplication.java，点击右上角绿色箭头运行。控制台输出日志即表示启动成功。

测试接口

浏览器访问 http://localhost:8080/hello，页面返回 Hello World!。

其他设置

配置 MySQL 连接

修改 src/main/resources/application.properties：

spring.datasource.url=jdbc:mysql://localhost:3306/your_db
spring.datasource.username=your_user
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update

配置日志文件

在 src/main/resources 目录下创建 logback-spring.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <!-- 定义日志文件的保存路径和文件名 -->
    <property name="LOG_FILE" value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java.io.tmpdir:-/tmp}}}/spring.log}"/>
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 文件输出 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_FILE}</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_FILE}.%d{yyyy-MM-dd}.gz</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <!-- 根日志记录器 -->
    <root level="info">
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
</configuration>

添加 .gitignore 文件

在项目主目录下创建 .gitignore 文件，内容如下：

HELP.md
target/
.mvn/wrapper/maven-wrapper.jar
!**/src/main/**/target/
!**/src/test/**/target/
### STS ###
.apt_generated
.classpath
.factorypath
.project
.settings
.springBeans
.sts4-cache
### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr
### NetBeans ###
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
build/
!**/src/main/**/build/
!**/src/test/**/build/
### VS Code ###
.vscode/
# Compiled class file
*.class
# Log file
*.log
# BlueJ files
*.ctxt
# Mobile Tools for Java (J2ME)
.mtj.tmp/
# Package Files
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar
# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
hs_err_pid*
replay_pid*
# 编译产物
*.class
*.jar
*.war
# 构建目录
/target/
/build/
# 日志文件
*.log
logs/
# 系统文件
.DS_Store
Thumbs.db

此文件用于防止多余依赖文件上传到 Git 仓库。