手把手教你从零搭建SpringBoot项目

手把手教你从零搭建 Spring Boot 项目（2026 最新版超详细教程）

Spring Boot 是目前 Java 后端开发最主流的框架，能帮你几分钟内创建一个可运行的生产级应用。下面我们从完全零基础开始，一步一步教你搭建一个标准的 Spring Boot 3.x 项目（基于 Java 17+），支持 Web 接口、热部署、配置文件等常用功能。

准备工作（5 分钟）

1. 安装 JDK

   • 推荐版本：JDK 21（当前最新 LTS）或JDK 17
   • 下载地址：https://adoptium.net/ （推荐 Eclipse Temurin）
   • 安装后验证：打开终端/命令提示符，输入

     java -version

     看到类似openjdk 21或17即成功。

2. 安装 IDE（推荐 IntelliJ IDEA）

   • 社区版免费：https://www.jetbrains.com/idea/download/
   • 或者用 VS Code + Java Extension Pack（轻量级）
   • 本教程以IntelliJ IDEA为例。

3. 安装 Maven（Spring Boot 默认使用）

   • IDEA 自带 Maven，无需单独安装。
   • 如果用命令行，确保 Maven 已配置环境变量：

     mvn -version

方法一：使用 Spring 官方在线生成器（最快，推荐新手）

1. 打开官网生成器：
   https://start.spring.io/

2. 配置项目参数（如下图设置）：

   • 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
   • Dependencies（右侧搜索添加常用依赖）：
     • Spring Web（必须，用于建 REST API）
     • Spring Boot DevTools（推荐，热部署）
     • Lombok（推荐，减少 boilerplate 代码）
     • Spring Data JPA（可选，如果要用数据库）
     • MySQL Driver（可选，配合 JPA）

   配置完成后点击GENERATE，下载一个.zip文件。

3. 解压并用 IDEA 打开

   • IntelliJ IDEA → Open → 选择解压后的文件夹 → OK
   • IDEA 会自动识别 Maven 项目并下载依赖（首次较慢，耐心等几分钟）

方法二：直接在 IntelliJ IDEA 中创建（更直观）

1. 打开 IDEA → New Project
2. 左侧选择Spring Initializr
3. 配置：
   • Initializr Service URL：默认 https://start.spring.io
   • Project SDK：选择你的 JDK 17/21
   • 点击 Next
4. 填写项目信息（同上）：
   • GroupId：com.example
   • ArtifactId：demo
   • Type：Maven
   • Language：Java
   • Java Version：17 或 21
5. 下一页选择依赖（Dependencies）：
   • 搜索并勾选：
     • Spring Web
     • Spring Boot DevTools
     • Lombok
6. 点击 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，内容类似：

packagecom.example.demo;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublicclassDemoApplication{publicstaticvoidmain(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

packagecom.example.demo;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.RestController;@RestControllerpublicclassHelloController{@GetMapping("/hello")publicStringhello(){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）
• 部署到云服务器

常见问题解决

你已经完成了从零到一的 Spring Boot 项目搭建！接下来可以尝试做个简单的 CRUD 接口，或者集成数据库。

如果你想继续深入某个部分（如集成 MySQL、Swagger 文档、登录认证），随时告诉我，我继续手把手教你！🚀