手把手教你从零搭建 Spring Boot 项目（2026 最新版超详细教程）
Spring Boot 是目前 Java 后端开发最主流的框架，能帮你几分钟内创建一个可运行的生产级应用。下面我们从完全零基础开始，一步一步教你搭建一个标准的 Spring Boot 3.x 项目（基于 Java 17+），支持 Web 接口、热部署、配置文件等常用功能。
准备工作（5 分钟）
- 安装 JDK
- 推荐版本：JDK 21（当前最新 LTS）或 JDK 17
- 下载地址：https://adoptium.net/ （推荐 Eclipse Temurin）
- 安装后验证：打开终端/命令提示符，输入
bash java -version
看到类似openjdk 21或17即成功。
- 安装 IDE（推荐 IntelliJ IDEA）
- 社区版免费：https://www.jetbrains.com/idea/download/
- 或者用 VS Code + Java Extension Pack（轻量级）
- 本教程以 IntelliJ IDEA 为例。
- 安装 Maven（Spring Boot 默认使用）
- IDEA 自带 Maven，无需单独安装。
- 如果用命令行，确保 Maven 已配置环境变量：
bash mvn -version
方法一：使用 Spring 官方在线生成器（最快，推荐新手）
- 打开官网生成器：
https://start.spring.io/ - 配置项目参数（如下图设置）：
- Project：Maven（默认）
- Language：Java
- Spring Boot：选择最新稳定版（当前 3.3.x 或更高）
- Project Metadata：
- Group：
com.example - Artifact：
demo - Name：
demo - Description：
Demo project for Spring Boot - Package name：
com.example.demo - Java：17 或 21
- Group：
- Dependencies（右侧搜索添加常用依赖）：
- Spring Web（必须，用于建 REST API）
- Spring Boot DevTools（推荐，热部署）
- Lombok（推荐，减少 boilerplate 代码）
- Spring Data JPA（可选，如果要用数据库）
- MySQL Driver（可选，配合 JPA）
.zip文件。
- 解压并用 IDEA 打开
- IntelliJ IDEA → Open → 选择解压后的文件夹 → OK
- IDEA 会自动识别 Maven 项目并下载依赖（首次较慢，耐心等几分钟）
方法二：直接在 IntelliJ IDEA 中创建（更直观）
- 打开 IDEA → New Project
- 左侧选择 Spring Initializr
- 配置：
- Initializr Service URL：默认 https://start.spring.io
- Project SDK：选择你的 JDK 17/21
- 点击 Next
- 填写项目信息（同上）：
- GroupId：com.example
- ArtifactId：demo
- Type：Maven
- Language：Java
- Java Version：17 或 21
- 下一页选择依赖（Dependencies）：
- 搜索并勾选：
- Spring Web
- Spring Boot DevTools
- Lombok
- 点击 Next → Finish
IDEA 会自动生成项目并下载依赖。
项目结构一览（标准布局）
生成后项目结构如下：
demo
├── src
│ ├── main
│ │ ├── java
│ │ │ └── com.example.demo
│ │ │ └── DemoApplication.java ← 主启动类
│ │ └── resources
│ │ ├── application.properties ← 配置文件
│ │ ├── static/ ← 静态资源（如 html、css）
│ │ └── templates/ ← 模板（如 Thymeleaf）
│ └── test
│ └── java
│ └── com.example.demo
│ └── DemoApplicationTests.java
├── pom.xml ← Maven 依赖管理
└── ...第一步：运行项目验证是否成功
找到主类 DemoApplication.java，内容类似：
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}直接点击类名旁边的绿色 ▶️ 运行按钮，或右键 → Run ‘DemoApplication’
控制台看到类似日志：
Tomcat started on port 8080 (http)
Started DemoApplication in X.XXX seconds打开浏览器访问：http://localhost:8080
看到 Whitelabel Error Page 是正常的（说明服务器启动成功，只是没定义接口）
第二步：创建一个简单的 REST 接口
新建一个 Controller 类：
右键 com.example.demo 包 → New → Java Class → 命名 HelloController
package com.example.demo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "Hello, Spring Boot! 你好，世界！";
}
}重新启动（或热部署自动生效），浏览器访问：
http://localhost:8080/hello
看到返回文字即成功！
第三步：常用配置（application.properties）
路径：src/main/resources/application.properties
# 服务端口（可改成 8081 等）
server.port=8080
# 项目上下文路径（可选）
# server.servlet.context-path=/api
# DevTools 热部署生效
spring.devtools.restart.enabled=true
# Lombok 注解处理器（如果用 Lombok）
lombok.enabled=true第四步：恭喜！你已成功搭建 Spring Boot 项目！
现在你拥有了一个完整的、可运行的 Spring Boot 工程，可以在此基础上继续开发：
- 添加数据库（MySQL + JPA）
- 集成 Redis、MyBatis
- 做前后端分离（返回 JSON）
- 部署到云服务器
常见问题解决
| 问题 | 解决方案 |
|---|---|
| 依赖下载慢 | 换阿里云镜像：在 pom.xml 加 配置 |
| 启动报错 Port 8080 already in use | 改 server.port 或杀掉占用进程 |
| Lombok 不生效 | 安装 IDEA Lombok 插件 + 开启 Annotation Processing |
| 热部署不生效 | 确保加了 DevTools 依赖，Ctrl+F9 重新编译 |
你已经完成了从零到一的 Spring Boot 项目搭建！接下来可以尝试做个简单的 CRUD 接口，或者集成数据库。
如果你想继续深入某个部分（如集成 MySQL、Swagger 文档、登录认证），随时告诉我，我继续手把手教你！🚀
