在 IntelliJ IDEA 中创建 Java Spring Boot 程序非常简单直接。以下是详细的步骤指南。
前提条件
-
已安装 IntelliJ IDEA Ultimate(社区版对 Spring 支持有限)
-
已安装 JDK 8+(推荐 JDK 17 或 21)
-
确保网络连接正常(用于下载依赖)
方法一:使用 Spring Initializr(推荐,最常用)
第1步:创建新项目
-
打开 IntelliJ IDEA,在欢迎界面点击 New Project
- 如果已经打开项目,通过 File > New > Project 创建
-
在 New Project 窗口中:
-
左侧选择 Spring Initializr
-
确认 Project SDK 已设置为你的 JDK
-
第2步:配置项目元数据
填写项目的基本信息:
-
Name : 项目名称(例如
my-spring-app) -
Location: 项目存储路径
-
Language : Java
-
Group : 组织标识,通常使用公司域名倒写(例如
com.example) -
Artifact: 项目标识(通常与 Name 相同)
-
Package name : 自动生成(
Group.Artifact) -
Packaging : Jar(推荐)
-
Java: 选择 JDK 版本(推荐 17 或 21)
第3步:选择依赖(关键步骤)
这是最重要的一步,选择项目需要的功能模块:
-
Spring Boot version: 选择稳定的正式版本
-
Dependencies : 点击 Add Dependencies 添加需要的起步依赖
常用依赖推荐:
-
Spring Web: 构建 Web 应用和 REST API(必选)
-
Spring Data JPA: 数据库持久层支持
-
Spring Boot DevTools: 热加载开发工具
-
Lombok: 简化 Java Bean 编写(强烈推荐)
-
MySQL Driver: MySQL 数据库驱动
-
Thymeleaf: 模板引擎(用于渲染 HTML)
-
Spring Security: 安全认证
第4步:完成创建
点击 Create,IDEA 会自动:
-
从 Spring Initializr 下载项目模板
-
创建标准项目结构
-
下载所有依赖包
方法二:从现有 Spring Initializr 项目导入
如果你已经在 start.spring.io 网站生成了项目:
-
解压下载的 ZIP 文件
-
在 IDEA 中选择 File > Open
-
选择解压后的文件夹
-
IDEA 会自动识别为 Spring Boot 项目并导入
项目结构说明
创建完成后,你会看到标准的 Spring Boot 项目结构:
java
my-spring-app/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/myspringapp/
│ │ │ └── MySpringAppApplication.java # 主启动类
│ │ └── resources/
│ │ ├── static/ # 静态资源
│ │ ├── templates/ # 模板文件
│ │ └── application.properties # 配置文件
│ └── test/ # 测试代码
├── pom.xml # Maven 配置
└── target/ # 编译输出
第5步:编写第一个 REST 控制器
-
创建 Controller 包:
-
在
src/main/java/com/example/myspringapp/右键 -
New > Package ,命名为
controller
-
-
创建 Controller 类:
-
在
controller包上右键 -
New > Java Class ,命名为
HelloController
-
-
编写代码:
java
package com.example.myspringapp.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "Hello, Spring Boot!";
}
@GetMapping("/user")
public User getUser() {
return new User("John", 25);
}
// 内部类
static class User {
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
// getters and setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
}
}
第6步:运行应用程序
-
找到主启动类 :打开
MySpringAppApplication.java -
点击运行:
-
点击类旁边的 绿色运行按钮 ▶️
-
或右键文件选择 Run 'MySpringAppApplication'
-
-
查看控制台:启动成功会显示:
bash
Tomcat started on port 8080
Started MySpringAppApplication in 2.5 seconds
第7步:测试应用
打开浏览器访问:
-
http://localhost:8080/hello- 显示 "Hello, Spring Boot!" -
http://localhost:8080/user- 返回 JSON 用户数据
配置技巧
1. 修改端口(可选)
在 application.properties 中添加:
bash
server.port=8081
2. 使用 YAML 配置(可选)
创建 application.yml 代替 application.properties:
bash
server:
port: 8081
spring:
datasource:
url: jdbc:mysql://localhost:3306/test
username: root
password: 123456
3. 热加载配置
如果添加了 Spring Boot DevTools 依赖:
-
修改代码后按
Ctrl + F9(Windows/Linux)或Cmd + F9(Mac)编译 -
应用会自动重新加载更改
常见问题解决
1. 依赖下载慢
-
检查网络连接
-
配置 Maven 镜像源
2. 端口被占用
-
修改
server.port -
停止占用端口的其他进程
3. 启动类找不到
-
确保主类有
@SpringBootApplication注解 -
确保在正确的包路径下
总结
通过以上步骤,你已经成功:
-
✅ 创建 Spring Boot 项目
-
✅ 配置项目依赖
-
✅ 编写 REST 控制器
-
✅ 运行和测试应用
这就是在 IntelliJ IDEA 中创建 Spring Boot 应用的完整流程!接下来你可以继续添加数据库、前端页面等功能。