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

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。