【工具使用】IDEA 社区版如何创建 Spring Boot 项目（详细教程）

IDEA 社区版如何创建 Spring Boot 项目（详细教程）

Spring Boot 以其简洁、高效的特性，成为 Java 开发的主流框架之一。虽然 IntelliJ IDEA 专业版提供了Spring Boot 项目向导，但 社区版（Community Edition） 并不自带 Spring Boot 项目创建功能。

那么，如何在 IDEA 社区版中创建一个 Spring Boot 项目呢？本篇文章将手把手教你 使用 IDEA 社区版 + Maven 快速创建 Spring Boot 项目，并成功运行第一个 Spring Boot 应用！🚀

---

1. 前置准备

在创建 Spring Boot 项目之前，确保你的开发环境已经准备就绪。

✅ 安装 JDK（推荐 JDK 17 或以上）

• 你可以在 Oracle JDK 官网 或 OpenJDK 下载并安装。
• 安装完成后，使用 java -version 检查：

  java -version
  

  例如：

  openjdk version "17.0.2" 2023-09-20 LTS
  

✅ 安装 IntelliJ IDEA 社区版

• 下载地址：JetBrains 官网
• 选择 Community（社区版） 进行安装。

✅ 安装 Maven（可选，如果 IDEA 没有自带）

• 下载：Maven 官网
• 配置环境变量，并运行以下命令检查安装是否成功：

  mvn -version
  

  例如：

  Apache Maven 3.8.4
  

✅ 确保网络畅通（国内建议配置阿里云 Maven 仓库）

---

2. 在 IDEA 社区版中创建 Spring Boot 项目

虽然社区版没有直接的 Spring Boot 项目向导，但我们可以手动创建 Maven 项目 并引入 Spring Boot 依赖。

2.1 创建 Maven 项目

1️⃣ 打开 IDEA 社区版，点击 “File” → “New” → “Project”
2️⃣ 选择 “Maven”，然后点击 Next
3️⃣ 在 “GroupId” 和 “ArtifactId” 中填写项目信息，例如：

• GroupId：com.example
• ArtifactId：springboot-demo
• Version：1.0.0（默认即可）
  4️⃣ 选择 JDK 版本（建议选择 17 或以上）
  5️⃣ 点击 Finish，等待 IDEA 创建项目

---

2.2 添加 Spring Boot 依赖

创建好 Maven 项目后，需要手动添加 Spring Boot 依赖。

📌 打开 pom.xml，添加以下内容：

<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>springboot-demo</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <java.version>17</java.version>
        <spring.boot.version>3.2.2</spring.boot.version>
    </properties>

    <dependencies>
        <!-- Spring Boot 核心依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <version>${spring.boot.version}</version>
        </dependency>

        <!-- Spring Boot Web 依赖（用于创建 REST API） -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>${spring.boot.version}</version>
        </dependency>

        <!-- 单元测试 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <version>${spring.boot.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring.boot.version}</version>
            </plugin>
        </plugins>
    </build>
</project>

💡 解释：

• spring-boot-starter：核心依赖，支持 Spring Boot 基础功能。
• spring-boot-starter-web：Web 依赖，支持 REST API。
• spring-boot-maven-plugin：用于打包和运行 Spring Boot 应用。

📌 点击右侧 Maven 面板 → “Reload All Maven Projects”，等待 IDEA 下载依赖。

---

3. 编写第一个 Spring Boot 应用

Maven 依赖配置完成后，我们可以开始编写 Spring Boot 代码。

3.1 创建 Spring Boot 启动类

在 src/main/java/com/example 目录下，新建 SpringbootDemoApplication.java：

package com.example;

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

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

3.2 创建 HelloWorld 控制器

在 com.example.controller 目录下，新建 HelloController.java：

package com.example.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

---

4. 运行 Spring Boot 项目

方法 1：使用 Maven

📌 在 IDEA 终端（Terminal） 中运行：

mvn spring-boot:run

方法 2：使用 Java 运行

📌 在 IDEA 左侧 “SpringbootDemoApplication.java” 右键 → “Run ‘SpringbootDemoApplication’”。

✅ 运行成功后，控制台会输出：

Tomcat started on port 8080
Started SpringbootDemoApplication in 2.345 seconds

📌 在浏览器访问：

http://localhost:8080/api/hello

✅ 返回结果：

Hello, Spring Boot!

---

5. 总结

🎯 在 IDEA 社区版创建 Spring Boot 项目的完整步骤：

1. 创建 Maven 项目（手动选择 Maven）。
2. 添加 Spring Boot 依赖（修改 pom.xml）。
3. 编写 Spring Boot 启动类（SpringbootDemoApplication.java）。
4. 创建 REST API 控制器（HelloController.java）。
5. 运行 Spring Boot 项目（Maven 或 Java 直接运行）。

✨ **虽然 IDEA 社区版没有 Spring Boot 向导，但通过手动配置 Maven 依赖，我们依然可以顺利开发 Spring Boot 应用！**🚀

---

📌 你学会了吗？ 如果觉得有帮助，欢迎点赞、收藏、转发！💡💬