一、前言
Spring Boot 是目前 Java 后端开发中最流行的框架之一，它大幅简化了 Spring 应用的配置流程，让开发者可以“开箱即用”，快速构建 Web、API、微服务等项目。
在开始实战之前，我们先完成开发环境的搭建。
二、环境准备清单
搭建 Spring Boot 环境需要以下组件：
| 工具 | 说明 | 推荐版本 |
|---|---|---|
| JDK (Java Development Kit) | Java 开发工具包 | JDK 17 或以上 |
| IDE (集成开发环境) | 编写与运行项目 | IntelliJ IDEA / Eclipse / VS Code |
| 构建工具 | 管理依赖与构建项目 | Maven（推荐）或 Gradle |
| 数据库（可选） | 用于持久化存储 | MySQL 8.x |
| Postman / 浏览器插件 | 测试接口请求 | 最新版 |
三、安装步骤
1️⃣ 安装 JDK
- 前往 Oracle 官方网站 或 OpenJDK 下载。
- 安装完成后配置环境变量：
- Windows： 设置
JAVA_HOME，并在Path中添加%JAVA_HOME%\bin - macOS/Linux： 在
~/.bashrc或~/.zshrc中添加：export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
- Windows： 设置
- 验证安装是否成功：
java -version
2️⃣ 安装 IntelliJ IDEA
- 推荐下载 Community (免费版) 或 Ultimate (付费版)。
- 下载地址：https://www.jetbrains.com/idea/download
- 安装完成后，建议安装以下插件：
- Lombok
- Spring Boot Assistant
- MyBatisX（如需数据库操作）
3️⃣ 安装 Maven
Spring Boot 默认使用 Maven 管理依赖。
- 下载：https://maven.apache.org/download.cgi
- 解压并配置环境变量：
export MAVEN_HOME=/usr/local/apache-maven-3.9.9 export PATH=$MAVEN_HOME/bin:$PATH - 验证安装：
mvn -v
💡 IDEA 提示：IntelliJ 自带 Maven，无需单独配置也可使用。
4️⃣ （可选）安装 MySQL 数据库
- 下载：https://dev.mysql.com/downloads/mysql/
- 安装后启动服务：
sudo service mysql start - 登录测试：
mysql -u root -p - 创建数据库：
CREATE DATABASE springboot_demo CHARACTER SET utf8mb4;
四、创建第一个 Spring Boot 项目
✅ 方法一：使用 Spring Initializr
- 打开 https://start.spring.io/
- 填写项目信息：
- Project：Maven Project
- Language：Java
- Spring Boot：3.x
- Dependencies：Spring Web、Lombok
- 点击“Generate”，下载生成的项目压缩包。
- 解压后，用 IntelliJ IDEA 打开即可。
✅ 方法二：在 IDEA 内创建
- 打开 IDEA → New Project → Spring Initializr
- 选择 Spring Boot 版本 与依赖项。
- 一键生成并运行
Application.java。
五、运行与测试
在 IDEA 中找到入口类（通常是 DemoApplication.java），点击 ▶️ 运行。
启动日志中若出现：
Tomcat started on port(s): 8080
Started DemoApplication in 2.345 seconds
说明项目启动成功 🎉
测试访问：
浏览器打开 http://localhost:8080
六、常见问题与解决
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 启动报错：找不到 JDK | 环境变量未配置 | 检查 JAVA_HOME |
| 依赖下载慢 | Maven 仓库被墙 | 修改为国内镜像（阿里云、清华源） |
| IDEA 控制台乱码 | 文件编码问题 | 设置为 UTF-8 |
发表回复