> 技术文档 > IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目

IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目


IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南

  • 1,IntelliJ IDEA与SpringBoot
  • 2,准备工作
  • 3,创建项目
  • 4,启动项目并验证
  • 5,编写服务接口并验证
  • 6,总结

对于刚接触 Java 开发的新手来说,SpringBoot 和 IntelliJ IDEA(简称 IDEA)的组合堪称 “最佳拍档”。SpringBoot 通过 “约定大于配置” 的理念,用自动配置和起步依赖简化开发流程,无需编写复杂的配置代码,就能快速搭建出可直接部署的 Web 应用、微服务等项目。例如添加spring-boot-starter-web依赖,就能自动集成 Spring MVC 和 Tomcat,直接上手开发接口。

1,IntelliJ IDEA与SpringBoot

  1. 什么是 SpringBoot?
    SpringBoot 是基于 Spring 框架的快速开发脚手架,由 Pivotal 团队开发,旨在简化 Spring 应用的初始搭建及开发过程。它通过 “约定大于配置” 的理念,自动配置项目依赖和基础架构,让开发者无需手动编写大量样板代码即可快速构建生产级应用。

  2. 什么是 IntelliJ IDEA?
    IDEA 是 JetBrains 公司开发的 Java 集成开发环境(IDE),以智能代码补全、强大的重构能力和丰富的插件生态著称,被广泛用于 Java、Kotlin、Android 等开发场景,分为社区版(免费)和旗舰版(付费)。

  3. IDEA 对 SpringBoot 的专属支持:
    Spring Initializr 模板: 一键创建 SpringBoot 项目,自动生成目录结构和启动类(如前文所述)。
    Application Configuration Assistant:可视化配置 application.yml,支持提示和校验配置项。
    微服务工具: 内置 Spring Cloud 服务发现、配置中心的可视化管理面板。
    开发效率提升: 热部署与快速重启:IDEA 的 Reload All Classes 功能配合 Spring Boot DevTools,修改代码后秒级生效。
    代码生成: 通过 Alt + Insert 快速生成 Spring 组件(如 Controller、Service),自动添加注解。
    依赖管理可视化: 在 Maven Projects 面板中直接添加 / 删除 SpringBoot 起步依赖,IDEA 自动更新 pom.xml 并下载依赖包。

2,准备工作

  1. 安装JDK:确保安装了 JDK 8 或更高版本,推荐使用 JDK 11 及以上版本,并配置好环境变量。
  2. 安装 IDEA:已安装 IntelliJ IDEA 2024.1.1 版本,可以是社区版或旗舰版。
  3. 安装 Maven:Spring Boot 项目通常使用 Maven 作为构建工具,需安装 Maven
    并配置好环境变量,可通过在命令行输入mvn -v验证是否安装成功。

3,创建项目

打开 IntelliJ IDEA 2024.1.1,选择 “File–New–Project”。
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
在弹出的对话框左侧菜单中选择 “Spring Boot”,填写对应的信息,点击 “Next”。
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
在弹出的对话框中选择 Spring Boot 版本以及所需的插件,点击 “Create”。
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
最后点击This window或 New Window完成创建项目
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
创建完成的项目目录结构如下图
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目

项目创建完成后,基本结构如下:

demo/├── src/│ ├── main/│ │ ├── java/│ │ │ └── com/│ │ │ └── example/│ │ │  └── demo/│ │ │  ├── DemoApplication.java # 启动类│ │ │  ├── controller/ # 控制器层│ │ │  ├── service/ # 服务层│ │ │  ├── repository/ # 数据访问层│ │ │  └── model/ # 实体类│ │ ├── resources/│ │ │ ├── application.properties # 配置文件(默认)│ │ │ ├── application.yml # 配置文件(YAML格式,可替代properties)│ │ │ ├── static/  # 静态资源│ │ │ └── templates/  # 模板文件│ └── test/│ └── java/│  └── com/│  └── example/│  └── demo/│ └── SpringbootDemoApplicationTests.java # 测试类├── pom.xml # Maven配置文件└── README.md # 项目说明文档

4,启动项目并验证

通过 IDEA 直接启动:找到启动类DemoApplication.java,点击类名左侧的绿色三角形按钮,或右键选择 “Run ‘DemoApplication’”。控制台输出相关信息,如 “Started SpringbootDemoApplication in xxx seconds” 和 “Tomcat started on port (s): 8080 (http)”,表示启动成功。
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
输出Identify and stop the process that’s listening on port 8080 or configure this application to listen on another port. 说明8080端口已被占用如下图:
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
修改端口
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
再次尝试启动,正常
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
验证 打开浏览器输入http://127.0.0.1:9999/ 看到以下结果则正常
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目

5,编写服务接口并验证

IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
在controller 包下创建一个java class 类名为:HelloController
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
代码内容

// 在controller包下创建HelloController.javapackage com.example.demo.controller;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RestController;@RestControllerpublic class HelloController { @GetMapping(\"/hello\") public String hello() { return \"Hello, Spring Boot!\"; }}

IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目
重启项目后访问http://localhost:9999/hello,应显示 “Hello, Spring Boot!”。
IntelliJ IDEA 2024.1.1 中快速创建 Spring Boot 项目的指南【图文教程】_idea新建一个springboot项目

6,总结

SpringBoot 通过 “约定大于配置” 简化 Java 开发,利用自动配置和起步依赖,让开发者快速搭建生产级应用,支持独立部署和多种生产级特性,适用于企业级 Web、微服务等场景。IntelliJ IDEA 则是强大的 Java 集成开发环境,凭借智能代码辅助、丰富的插件生态、高效的调试工具,能大幅提升开发效率。二者结合优势显著,IDEA 内置的 Spring Initializr 等功能与 SpringBoot 深度适配,帮助开发者更便捷地创建、开发和调试 SpringBoot 项目,是 Java 开发者的高效组合。