Spring Boot

v3.x

Java

官方网站 GitHub

Spring Boot 是 Java 生态最流行的企业级开发框架。强烈推荐使用 IntelliJ IDEA 运行，它提供了最佳的 Spring 开发体验。

📋 前置要求

Java JDK 17+ 已安装

IntelliJ IDEA 已安装（推荐 Ultimate 版，社区版也可以）

已下载生成的项目代码

🚀 使用 IntelliJ IDEA 运行（推荐）

第 1 步：用 IDEA 打开项目

打开 IntelliJ IDEA
选择 File → Open
选择项目中的 backend 目录
等待 IDEA 自动导入 Maven/Gradle 依赖（右下角会显示进度）

首次打开

 首次打开会下载大量依赖，可能需要 5-10 分钟。请确保网络畅通，或配置 Maven 镜像加速。 

第 2 步：配置数据库

编辑 src/main/resources/application.yml：

yaml

spring:
  datasource:
    # SQLite（默认，无需额外配置）
    url: jdbc:sqlite:./dev.db
    
    # MySQL（需要先创建数据库）
    # url: jdbc:mysql://localhost:3306/mydb
    # username: root
    # password: your_password
    
    # PostgreSQL（需要先创建数据库）
    # url: jdbc:postgresql://localhost:5432/mydb
    # username: postgres
    # password: your_password

第 3 步：运行项目

找到启动类（通常是 Application.java 或 XxxApplication.java）
右键点击 → Run 'Application'
或者点击类名左侧的 绿色三角形 按钮

启动成功

 看到控制台输出 `Started Application in x.xxx seconds` 就是启动成功了！ 

第 4 步：访问服务

API 地址：http://localhost:8080
Swagger 文档：http://localhost:8080/swagger-ui.html

📦 持久层框架说明

根据你选择的技术栈，项目会使用不同的数据访问框架：

MyBatis Plus

注意

MyBatis Plus **不是 ORM**，它是一个 MyBatis 的增强工具，提供了通用 CRUD、分页、代码生成等功能。

核心思想：SQL 完全可控，适合需要写复杂 SQL 的场景。

特点：

通用 CRUD 方法，无需写简单 SQL
灵活的条件构造器
强大的代码生成器
中文文档友好，国内使用最广

java

// 示例：继承 BaseMapper 即可获得通用 CRUD
@Mapper
public interface UserMapper extends BaseMapper<User> {
    // 复杂查询可以自己写
    @Select("SELECT * FROM user WHERE status = #{status}")
    List<User> selectByStatus(Integer status);
}

Spring Data JPA

JPA 是真正的 ORM（对象关系映射） 框架，自动处理对象和数据库表的映射。

特点：

方法名自动生成 SQL
自动建表、更新表结构
跨数据库迁移容易
适合 CRUD 为主的场景

java

// 示例：方法名自动生成查询
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
    List<User> findByStatusAndCreatedAtAfter(Integer status, LocalDateTime date);
}

选型建议

场景	推荐
需要复杂 SQL、追求性能	MyBatis Plus
CRUD 为主、快速开发	Spring Data JPA
团队熟悉 MyBatis	MyBatis Plus
Kotlin 项目	Ktorm

🔧 命令行运行（可选）

如果不用 IDEA，也可以用命令行运行：

bashbackend

        $
        ./mvnw spring-boot:run

或 Windows：

cmdbackend

        
        mvnw.cmd spring-boot:run

🛠️ Maven 镜像配置

依赖下载很慢？编辑 ~/.m2/settings.xml：

xml

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Aliyun Maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>