使用 IntelliJ IDEA 运行 Spring Boot 项目（超详细教程）

Spring Boot 是一种快速开发 Java 应用的框架，配合 IntelliJ IDEA（简称 IDEA）可以极大地提升开发效率。本教程将带你详细了解如何在 IDEA 中创建和运行一个 Spring Boot 项目。按照以下步骤一步步操作，你会发现过程非常简单且易于操作。

---

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

1️⃣ 安装和配置

1.1 安装 IntelliJ IDEA

首先，确保你已经安装了 IntelliJ IDEA。可以从 JetBrains 官网下载并安装最新版本的 IDEA。推荐安装 Ultimate 版，因为它包含对 Spring Boot 的更全面支持。

1. 下载 IDEA：

   • 访问 JetBrains 官网。
   • 选择你计算机的操作系统，并下载 IntelliJ IDEA Ultimate 或 Community 版本。Ultimate 版本支持更多企业级功能。

2. 安装 IDEA：

   • 下载完成后，运行安装包，按照提示完成安装。
   • 安装过程中，选择适当的选项和路径，一般使用默认设置即可。

1.2 安装 Java 和 Maven

确保你的系统已经安装了 Java Development Kit (JDK) 和 Maven。Spring Boot 项目通常使用 JDK 8 或更高版本。

1. 检查 JDK 安装：
   打开命令行或终端，输入以下命令检查是否已安装 JDK：

   java -version
   

   • 如果没有安装，请从 Oracle 官网 或 OpenJDK 项目下载安装。

2. 检查 Maven 安装：
   输入以下命令检查是否已安装 Maven：

   mvn -version
   

   • 如果没有安装，请从 Maven 官网下载并安装。

2️⃣ 创建 Spring Boot 项目

2.1 使用 Spring Initializr 创建项目

Spring Initializr 是一个快速生成 Spring Boot 项目的在线平台。你可以通过以下方式创建一个新的 Spring Boot 项目：

1. 访问 Spring Initializr 网站：
   打开浏览器，访问 Spring Initializr。

2. 填入项目信息：

   • Project: 选择 Maven Project。
   • Language: 选择 Java。
   • Spring Boot Version: 选择最新的稳定版本。
   • Project Metadata（按需填写）：
     • Group: com.example
     • Artifact: my-spring-boot-app
     • Name: my-spring-boot-app
     • Description: Demo project for Spring Boot
     • Package name: 自动生成，通常保持默认。
     • Packaging: Jar
     • Java: 8 或更高版本

3. 选择依赖：
   根据需要选择一些常用依赖：

   • Spring Web
   • Spring Data JPA
   • H2 Database
   • Spring Boot DevTools

4. 生成项目：
   点击 Generate 按钮下载项目压缩包。

5. 解压项目：
   下载完成后，解压项目压缩包到本地某个目录。

2.2 使用 Maven 创建项目

你也可以使用 Maven 命令行创建一个新的 Spring Boot 项目：

1. 打开终端或命令提示符，导航到你希望存放项目的目录。

2. 执行以下命令创建项目：

   mvn archetype:generate -DgroupId=com.example -DartifactId=my-spring-boot-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
   

3. 进入项目目录：

   cd my-spring-boot-app
   

4. 创建一个新的 pom.xml 文件，添加 Spring Boot 依赖：

   <project xmlns="http://maven.apache.org/POM/4.0.0"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.example</groupId>
       <artifactId>my-spring-boot-app</artifactId>
       <version>1.0-SNAPSHOT</version>
   
       <parent>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-parent</artifactId>
           <version>2.6.1</version>
       </parent>
   
       <dependencies>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-web</artifactId>
           </dependency>
           <!-- 其他依赖 -->
       </dependencies>
   
       <build>
           <plugins>
               <plugin>
                   <groupId>org.springframework.boot</groupId>
                   <artifactId>spring-boot-maven-plugin</artifactId>
               </plugin>
           </plugins>
       </build>
   </project>
   

3️⃣ 导入项目到 IntelliJ IDEA

3.1 导入已有项目

1. 打开 IntelliJ IDEA：
   启动 IDEA，进入欢迎界面。

2. 导入项目：

   • 点击 Import Project（如果是首次使用 IDE），或者在文件菜单中选择 File -> New -> Project from Existing Sources...。
   • 选择之前解压或创建的项目目录，然后点击 OK。

3. 选择项目类型：
   IDEA 通常会自动检测到项目类型。如果检测不到，你可以手动选择 Import project from external model，然后选择 Maven。

4. 完成导入：
   IDEA 会自动解析项目并下载相关依赖。等待过程完成后，项目即成功导入。

4️⃣ 运行 Spring Boot 项目

4.1 通过 IDEA 的运行配置启动

1. 打开主类：
   打开带有 @SpringBootApplication 注解的主类（通常在 src/main/java 目录下）。

2. 运行项目：

   • 在主类上方点击绿色的运行按钮，或者右键点击类文件并选择 Run 'MainClass'。
   • 如果是首次运行，你也可以点击工具栏中的 Run 按钮（绿色箭头）。

package com.example.myspringbootapp;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MySpringBootAppApplication {
    public static void main(String[] args) {
        SpringApplication.run(MySpringBootAppApplication.class, args);
    }
}

4.2 使用 Maven 插件启动

1. 打开 Maven 工具窗口：
   点击右侧的 Maven 图标打开 Maven 工具窗口。

2. 找到项目的生命周期任务：
   展开项目的 Lifecycle 任务。

3. 运行 spring-boot:run：
   双击 spring-boot:run 任务来启动 Spring Boot 应用。

mvn spring-boot:run

5️⃣ 调试 Spring Boot 项目

5.1 设置断点和调试

1. 打开要调试的类：
   在代码编辑器中打开你希望调试的类文件。

2. 设置断点：
   在左侧行号区域点击设置断点（红点）。

3. 启动调试：

   • 点击工具栏中的 Debug 按钮（带虫子的绿色箭头），或者右键主类文件选择 Debug 'MainClass'。
   • IDEA 会启动应用并在断点处停下来，你可以使用调试工具窗口进行逐行调试、查看变量、表达式计算等。

6️⃣ 其他常见问题和解决方法

6.1 问题 1：依赖解析失败

解决方式：

• 检查 pom.xml 文件中是否正确配置了依赖和仓库。
• 确保网络连接良好，可能需要配置公司或学校的代理服务器。
• 在 IDEA 中尝试点击 Maven 工具窗口中的刷新按钮，重新加载项目。

6.2 问题 2：项目无法运行，报端口占用错误

解决方式：

• 检查是否有其他程序占用了默认的 8080 端口。
• 修改 application.properties 或 application.yml 文件，更改服务器端口：

  server.port=8081
  

🎉 总结

通过上述详细步骤，我们成功地在 IntelliJ IDEA 中创建并运行了一个 Spring Boot 项目。IDEA 提供了丰富的功能和便捷的操作，能够大幅提升开发效率。希望这篇教程能帮助你快速上手 Spring Boot 项目开发。、