【Java框架篇】IntelliJ IDEA 创建 Spring Boot 项目 的详细步骤指南

以下是使用 ​IntelliJ IDEA​ 创建 ​Spring Boot 项目​ 的详细步骤指南，涵盖从项目初始化到运行的全过程：

​一、环境准备​

1. ​安装JDK​

   • 版本要求：​JDK 8+​​（推荐JDK 11或17，LTS版本）
   • 验证安装：

     java -version

2. ​安装IntelliJ IDEA​

   • 版本要求：​2020.3+​​（推荐最新版）
   • 下载地址：JetBrains官网

3. ​配置Maven/Gradle​（可选）

   • IDEA内置Maven，如需自定义版本：
     File → Settings → Build, Execution, Deployment → Build Tools → Maven

​二、创建Spring Boot项目​

​方式1：通过Spring Initializr（推荐）​​

1. ​打开创建向导​

   • 启动IDEA → File → New → Project
   • 选择左侧菜单：​Spring Initializr​

2. ​填写项目信息​

   • ​Project SDK​：选择已安装的JDK
   • ​Name​：项目名称（如demo）
   • ​Location​：项目存储路径
   • ​Type​：Maven（默认）或 Gradle
   • ​Language​：Java
   • ​Packaging​：Jar（推荐）或 War
   • ​Java Version​：选择JDK版本（如11）

3. ​选择依赖​

   • 在 ​Dependencies​ 区域搜索并勾选：
     • Spring Web（构建REST API）
     • Lombok（简化Getter/Setter代码）
     • Spring Boot DevTools（热部署）
     • 其他按需添加（如Spring Data JPA、MySQL Driver）
   • 点击 ​Next​ → ​Finish​ 完成创建。

​方式2：手动导入已有项目​

1. 访问 start.spring.io 在线生成项目包。
2. 下载ZIP文件后，在IDEA中选择：
   File → Open → 解压后的项目文件夹。

​三、项目结构解析​

创建完成后，项目目录如下：

demo/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       ├── DemoApplication.java  # 主启动类
│   │   │       └── controller/           # 控制器层
│   │   └── resources/
│   │       ├── application.properties    # 配置文件
│   │       ├── static/                    # 静态资源（CSS/JS）
│   │       └── templates/                # 模板文件（Thymeleaf）
│   └── test/                             # 测试代码
├── pom.xml                              # Maven依赖管理
└── target/                             # 编译输出目录

​四、编写第一个REST接口​

1. ​创建Controller​
   在com.example.demo.controller包下新建HelloController.java：

   import org.springframework.web.bind.annotation.*;
   
   @RestController
   @RequestMapping("/api")
   public class HelloController {
       @GetMapping("/hello")
       public String sayHello() {
           return "Hello, Spring Boot!";
       }
   }

2. ​启动项目​

   • 打开主类 DemoApplication.java → 点击左侧绿色运行按钮。
   • 控制台输出 Started DemoApplication in X seconds 表示启动成功。

3. ​测试接口​
   浏览器或Postman访问：

   http://localhost:8080/api/hello

   返回结果：Hello, Spring Boot!

​五、常用配置​

​1. 修改端口号​

在 application.properties 中添加：

server.port=9090

​2. 开启热部署​

1. 确保已勾选 Spring Boot DevTools 依赖。
2. IDEA设置：
   File → Settings → Build, Execution, Deployment → Compiler → 勾选 ​Build project automatically。
3. 快捷键 Ctrl + F9 手动触发重新编译。

​3. 数据库连接（MySQL示例）​​

# application.properties
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update

​六、项目打包与运行​

​1. 打包为JAR​

1. 打开Maven工具栏（右侧）→ 点击 Lifecycle → package。
2. 生成的JAR位于 target/demo-0.0.1-SNAPSHOT.jar。

​2. 运行JAR​

java -jar target/demo-0.0.1-SNAPSHOT.jar

​七、常见问题解决​

1. ​依赖下载失败​

   • 检查Maven镜像源（推荐阿里云镜像）：
     修改 settings.xml：

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

2. ​端口冲突​

   • 错误信息：Port 8080 already in use
   • 解决方案：

     # Linux/Mac
     lsof -i:8080
     kill -9 <PID>

​八、下一步学习建议​

1. ​整合数据库​：
   • 使用Spring Data JPA或MyBatis操作MySQL
2. ​前端整合​：
   • 使用Thymeleaf渲染页面
   • 分离开发：Vue.js + Spring Boot
3. ​进阶功能​：
   • 用户认证（Spring Security）
   • 微服务开发（Spring Cloud）

通过以上步骤，您已成功创建并运行一个Spring Boot项目！如需更复杂的项目模板，可参考GitHub上的Spring Boot示例。