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 项目的完整步骤:
- 创建 Maven 项目(手动选择
Maven
)。 - 添加 Spring Boot 依赖(修改
pom.xml
)。 - 编写 Spring Boot 启动类(
SpringbootDemoApplication.java
)。 - 创建 REST API 控制器(
HelloController.java
)。 - 运行 Spring Boot 项目(Maven 或 Java 直接运行)。
✨ **虽然 IDEA 社区版没有 Spring Boot 向导,但通过手动配置 Maven 依赖,我们依然可以顺利开发 Spring Boot 应用!**🚀
📌 你学会了吗? 如果觉得有帮助,欢迎点赞、收藏、转发!💡💬