当前位置：首页 > news >正文

SpringBoot 项目搭建的 4 种常用方式，从入门到实践

news 2025/7/16 13:46:28

SpringBoot 作为简化 Spring 应用开发的框架，凭借其 “开箱即用” 的特性深受开发者喜爱。本文将详细介绍 4 种常用的 SpringBoot 项目搭建方式，无论你是新手还是有经验的开发者，都能找到适合自己的方式快速上手。

一、方式 1：IDEA 直接从 Spring 官方脚手架创建

适用场景：已安装 IDEA，希望快速创建项目，无需手动下载压缩包。

步骤详解：

打开 IDEA，新建项目
打开 IDEA 后，点击 File -> New -> Project，在左侧菜单中找到 Spring Initializr（IDEA 默认集成了 Spring 官方的脚手架），右侧选择 Default (https://start.spring.io) 作为脚手架地址，点击「Next」。
配置项目基本信息
- Group：组织标识（如 com.qcby）
- Artifact：项目名称（如 springboot-demo）
- Type：选择 Maven（默认）
- Language：选择 Java
- Version：项目版本（如 0.0.1-SNAPSHOT）
- Java Version：根据 SpringBoot 版本选择（SpringBoot 3.x 需 Java 17+，2.x 可兼容 Java 8）
  配置完成后点击「Next」。
选择所需依赖模块
这一步是核心，根据项目需求勾选依赖：
- 基础 Web 开发：勾选 Web -> Spring Web（必选，包含 SpringMVC 和内嵌 Tomcat）
- 数据库相关：若需操作数据库，可勾选 SQL -> MySQL Driver、MyBatis 等
  勾选完成后点击「Next」。
确认项目路径并创建
选择项目保存路径，点击「Finish」。IDEA 会自动从 Spring 官方仓库下载依赖并构建项目结构。
验证项目是否创建成功
项目创建后，IDEA 会自动生成主启动类（类名默认是 XXXApplication），类上标注 @SpringBootApplication 注解，这是 SpringBoot 的核心注解，用于开启自动配置。
运行主启动类的 main 方法，若控制台输出 SpringBoot 启动日志，说明项目搭建成功。

二、方式 2：从 Spring 官方网站下载，再用 IDEA 打开

适用场景：IDEA 未集成脚手架，或需要手动控制下载过程。

步骤详解：

访问 Spring 官方脚手架
打开浏览器，访问 Spring Initializr（Spring 官方提供的项目生成工具）。
配置项目信息
页面配置项与方式 1 一致：
- 填写 Group、Artifact、Java Version 等基本信息
- 选择项目类型（Maven/Gradle）、打包方式（默认 Jar，推荐使用 Jar，无需额外部署 Tomcat）
选择依赖模块
在页面下方的「Dependencies」搜索框中，输入需要的依赖（如 Spring Web、MySQL Driver），点击添加。
下载项目压缩包
配置完成后，点击页面底部的「Generate」按钮，生成项目压缩包（.zip 格式）并下载到本地。
用 IDEA 打开项目
- 解压下载的压缩包，得到项目文件夹
- 打开 IDEA，点击 File -> Open，选择解压后的项目文件夹，等待 IDEA 加载依赖（首次加载可能较慢，需耐心等待）。
启动项目验证
找到主启动类（默认在 src/main/java/com/xxx/xxxApplication.java），运行 main 方法，若成功启动，说明搭建完成。

三、方式 3：IDEA 从阿里云脚手架创建

适用场景：访问 Spring 官方仓库较慢（因网络原因），阿里云提供了国内镜像，速度更快。

步骤详解：

打开 IDEA，选择阿里云脚手架
新建项目时，选择 Spring Initializr，在右侧的「Server URL」中输入阿里云脚手架地址：https://start.aliyun.com，点击「Next」。
配置项目信息
与方式 1 类似，填写 Group、Artifact 等信息，注意阿里云脚手架可能默认推荐一些国内常用依赖（如阿里云 OSS、Druid 等），按需选择即可。
选择依赖模块
核心依赖（如 Spring Web）的选择与官方脚手架一致，若需使用阿里云生态的组件（如短信服务、对象存储），可直接勾选对应依赖。
完成创建并验证
后续步骤与方式 1 相同，确认路径后创建项目，运行主启动类验证是否成功。

四、方式 4：Maven 项目改造为 SpringBoot 项目

适用场景：已有 Maven 项目，想在现有基础上集成 SpringBoot，或希望深入理解 SpringBoot 的依赖结构。

步骤详解：

创建基础 Maven 项目
打开 IDEA，点击 File -> New -> Project，选择 Maven，不勾选任何模板（保持项目纯净），填写 Group、Artifact 后点击「Finish」，得到一个空的 Maven 项目。

修改 pom.xml 文件，添加 SpringBoot 依赖
SpringBoot 项目的核心是通过父依赖（spring-boot-starter-parent）统一管理版本和依赖，因此需要在 pom.xml 中添加以下配置：

<?xml version="1.0" encoding="UTF-8"?>
<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><!-- 引入SpringBoot父依赖（核心） --><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.7.15</version> <!-- 2.x版本兼容Java 8，3.x需Java 17+ --></parent><groupId>com.itheima</groupId><artifactId>springboot-maven-demo</artifactId><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>8</maven.compiler.source> <!-- 若用Java 8，需对应SpringBoot 2.x --><maven.compiler.target>8</maven.compiler.target></properties><dependencies><!-- 引入Web启动器（包含SpringMVC、Tomcat等） --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>
</project>

关键说明：

spring-boot-starter-parent：SpringBoot 的父依赖，定义了常用依赖的版本，避免手动指定版本冲突。
spring-boot-starter-web：Web 开发的启动器，自动引入 SpringMVC、内嵌 Tomcat 等必要组件。

创建主启动类
SpringBoot 项目必须有一个标注 @SpringBootApplication 的主启动类，用于启动应用。
在 src/main/java 下按包路径（如 com.itheima）创建类 Application：
```
package com.itheima;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication // 核心注解：开启自动配置、组件扫描
public class Application {public static void main(String[] args) {// 启动SpringBoot应用SpringApplication.run(Application.class, args);}
}
```
注意：
- 主启动类的包路径建议为项目的根包（如 com.itheima），这样 @SpringBootApplication 能自动扫描子包下的组件。
- SpringApplication.run(...) 方法是启动入口，参数为当前类的 Class 对象。
验证改造结果
运行主启动类的 main 方法，若控制台输出 SpringBoot 启动日志（包含 Started Application in xx seconds），说明改造成功。

总结与注意事项

版本兼容性：
- SpringBoot 3.x 最低要求 Java 17，若需使用 Java 8，建议选择 SpringBoot 2.x（如 2.7.15）。
- 依赖版本由父依赖统一管理，无需手动指定，避免版本冲突。
核心要素：
- 无论哪种搭建方式，都需要 spring-boot-starter-parent 父依赖（或等价的依赖管理）。
- 必须有标注 @SpringBootApplication 的主启动类，这是 SpringBoot 的 “入口”。
选择建议：
- 新手推荐方式 1 或 3（IDEA 直接创建，简单高效）。
- 网络不佳时优先选方式 3（阿里云镜像）。
- 已有 Maven 项目或想深入理解原理，选方式 4。