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

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

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

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

步骤详解:

  1. 打开 IDEA,新建项目

    打开 IDEA 后,点击 File -> New -> Project,在左侧菜单中找到 Spring Initializr(IDEA 默认集成了 Spring 官方的脚手架),右侧选择 Default (https://start.spring.io) 作为脚手架地址,点击「Next」。

  2. 配置项目基本信息

    • 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」。
  3. 选择所需依赖模块

    这一步是核心,根据项目需求勾选依赖:

    • 基础 Web 开发:勾选 Web -> Spring Web(必选,包含 SpringMVC 和内嵌 Tomcat)
    • 数据库相关:若需操作数据库,可勾选 SQL -> MySQL DriverMyBatis
      勾选完成后点击「Next」。
  4. 确认项目路径并创建

    选择项目保存路径,点击「Finish」。IDEA 会自动从 Spring 官方仓库下载依赖并构建项目结构。

  5. 验证项目是否创建成功

    项目创建后,IDEA 会自动生成主启动类(类名默认是 XXXApplication),类上标注 @SpringBootApplication 注解,这是 SpringBoot 的核心注解,用于开启自动配置。

    运行主启动类的 main 方法,若控制台输出 SpringBoot 启动日志,说明项目搭建成功。

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

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

步骤详解:

  1. 访问 Spring 官方脚手架

    打开浏览器,访问 Spring Initializr(Spring 官方提供的项目生成工具)。

  2. 配置项目信息

    页面配置项与方式 1 一致:

    • 填写 Group、Artifact、Java Version 等基本信息
    • 选择项目类型(Maven/Gradle)、打包方式(默认 Jar,推荐使用 Jar,无需额外部署 Tomcat)
  3. 选择依赖模块

    在页面下方的「Dependencies」搜索框中,输入需要的依赖(如 Spring WebMySQL Driver),点击添加。

  4. 下载项目压缩包

    配置完成后,点击页面底部的「Generate」按钮,生成项目压缩包(.zip 格式)并下载到本地。

  5. 用 IDEA 打开项目

    • 解压下载的压缩包,得到项目文件夹
    • 打开 IDEA,点击 File -> Open,选择解压后的项目文件夹,等待 IDEA 加载依赖(首次加载可能较慢,需耐心等待)。
  6. 启动项目验证

    找到主启动类(默认在 src/main/java/com/xxx/xxxApplication.java),运行 main 方法,若成功启动,说明搭建完成。

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

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

步骤详解:

  1. 打开 IDEA,选择阿里云脚手架

    新建项目时,选择 Spring Initializr,在右侧的「Server URL」中输入阿里云脚手架地址:https://start.aliyun.com,点击「Next」。

  2. 配置项目信息

    与方式 1 类似,填写 Group、Artifact 等信息,注意阿里云脚手架可能默认推荐一些国内常用依赖(如阿里云 OSS、Druid 等),按需选择即可。

  3. 选择依赖模块

    核心依赖(如 Spring Web)的选择与官方脚手架一致,若需使用阿里云生态的组件(如短信服务、对象存储),可直接勾选对应依赖。

  4. 完成创建并验证

    后续步骤与方式 1 相同,确认路径后创建项目,运行主启动类验证是否成功。

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

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

步骤详解:

  1. 创建基础 Maven 项目

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

  2. 修改 pom.xml 文件,添加 SpringBoot 依赖

    SpringBoot 项目的核心是通过父依赖(spring-boot-starter-parent)统一管理版本和依赖,因此需要在 pom.xml 中添加以下配置:

    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 等必要组件。
  3. 创建主启动类

    SpringBoot 项目必须有一个标注 @SpringBootApplication 的主启动类,用于启动应用。

    src/main/java 下按包路径(如 com.itheima)创建类 Application

    java 复制代码
    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 对象。
  4. 验证改造结果

    运行主启动类的 main 方法,若控制台输出 SpringBoot 启动日志(包含 Started Application in xx seconds),说明改造成功。

总结与注意事项

  1. 版本兼容性

    • SpringBoot 3.x 最低要求 Java 17,若需使用 Java 8,建议选择 SpringBoot 2.x(如 2.7.15)。
    • 依赖版本由父依赖统一管理,无需手动指定,避免版本冲突。
  2. 核心要素

    • 无论哪种搭建方式,都需要 spring-boot-starter-parent 父依赖(或等价的依赖管理)。
    • 必须有标注 @SpringBootApplication 的主启动类,这是 SpringBoot 的 "入口"。
  3. 选择建议

    • 新手推荐方式 1 或 3(IDEA 直接创建,简单高效)。
    • 网络不佳时优先选方式 3(阿里云镜像)。
    • 已有 Maven 项目或想深入理解原理,选方式 4。

通过以上 4 种方式,你可以根据自己的场景快速搭建 SpringBoot 项目,开启高效的 Spring 开发之旅。如果在搭建过程中遇到依赖下载慢的问题,可配置 Maven 镜像(如阿里云镜像)加速依赖下载~

相关推荐
武子康17 分钟前
大数据-89 Spark应用必备:进程通信、序列化机制与RDD执行原理
大数据·后端·spark
SheldonChang27 分钟前
Onlyoffice集成与AI交互操作指引(Iframe版)
java·人工智能·ai·vue·onlyoffice·postmessage
shark_chili28 分钟前
JITWatch实战指南:深入Java即时编译优化的黑科技工具
后端
数据爬坡ing34 分钟前
C++ 类库管理系统的分析与设计:面向对象开发全流程实践
java·运维·开发语言·c++·软件工程·软件构建·运维开发
DKPT43 分钟前
JVM新生代和老生代比例如何设置?
java·开发语言·jvm·笔记·学习
知彼解己1 小时前
JVM 运行时数据区域
java·开发语言·jvm
绝无仅有1 小时前
从拉取代码到前端运行访问:Vue 前端项目的常规启动流程
后端·面试·github
小蒜学长1 小时前
spring boot驴友结伴游网站的设计与实现(代码+数据库+LW)
java·数据库·spring boot·后端
江团1io01 小时前
一篇文章带你彻底搞懂 JVM 垃圾收集器
java·开发语言·jvm
CodeLongBear1 小时前
深入理解 JVM 字节码文件:从组成结构到 Arthas 工具实践
java·jvm·后端