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

目录

• 一、方式 1：IDEA 直接从 Spring 官方脚手架创建
• 步骤详解：
• 二、方式 2：从 Spring 官方网站下载，再用 IDEA 打开
• 步骤详解：
• 三、方式 3：IDEA 从阿里云脚手架创建
• 步骤详解：
• 四、方式 4：Maven 项目改造为 SpringBoot 项目
• 步骤详解：
• 总结与注意事项

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 Driver、MyBATis 等

     勾选完成后点击「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 Web、MySQL 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 相同，确认路径后创建项目，运行主启动类验证是否成python功。

四、方式 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 version="1.0" encoding="UTF-8"?>
   <prohttp://www.devze.comject 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：

   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 镜像（如阿里云镜像）加速依赖下载～

到此这篇关于SpringBoot 项目搭建的 4 种常用方式从入门到实践的文章就介绍到这了,更多相关springboot项目搭建内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！