SpringBoot 項目搭建的 4 種常用方式(從入門到實踐)

更新時間：2025年07月18日 09:16:54 作者：越來越無動于衷

本文將詳細介紹 4 種常用的 SpringBoot 項目搭建方式,無論你是新手還是有經(jīng)驗的開發(fā)者,都能找到適合自己的方式快速上手,感興趣的朋友一起看看吧

SpringBoot 作為簡化 Spring 應用開發(fā)的框架，憑借其 “開箱即用” 的特性深受開發(fā)者喜愛。本文將詳細介紹 4 種常用的 SpringBoot 項目搭建方式，無論你是新手還是有經(jīng)驗的開發(fā)者，都能找到適合自己的方式快速上手。

一、方式 1：IDEA 直接從 Spring 官方腳手架創(chuàng)建

適用場景：已安裝 IDEA，希望快速創(chuàng)建項目，無需手動下載壓縮包。

步驟詳解：

打開 IDEA，新建項目
打開 IDEA 后，點擊 File -> New -> Project，在左側(cè)菜單中找到 Spring Initializr（IDEA 默認集成了 Spring 官方的腳手架），右側(cè)選擇 Default (https://start.spring.io) 作為腳手架地址，點擊「Next」。
配置項目基本信息
- Group：組織標識（如 com.qcby）
- Artifact：項目名稱（如 springboot-demo）
- Type：選擇 Maven（默認）
- Language：選擇 Java
- Version：項目版本（如 0.0.1-SNAPSHOT）
- Java Version：根據(jù) SpringBoot 版本選擇（SpringBoot 3.x 需 Java 17+，2.x 可兼容 Java 8）
  配置完成后點擊「Next」。
選擇所需依賴模塊
這一步是核心，根據(jù)項目需求勾選依賴：
- 基礎(chǔ) Web 開發(fā)：勾選 Web -> Spring Web（必選，包含 SpringMVC 和內(nèi)嵌 Tomcat）
- 數(shù)據(jù)庫相關(guān)：若需操作數(shù)據(jù)庫，可勾選 SQL -> MySQL Driver、MyBatis 等
  勾選完成后點擊「Next」。
確認項目路徑并創(chuàng)建
選擇項目保存路徑，點擊「Finish」。IDEA 會自動從 Spring 官方倉庫下載依賴并構(gòu)建項目結(jié)構(gòu)。
驗證項目是否創(chuàng)建成功
項目創(chuàng)建后，IDEA 會自動生成主啟動類（類名默認是 XXXApplication），類上標注 @SpringBootApplication 注解，這是 SpringBoot 的核心注解，用于開啟自動配置。
運行主啟動類的 main 方法，若控制臺輸出 SpringBoot 啟動日志，說明項目搭建成功。

二、方式 2：從 Spring 官方網(wǎng)站下載，再用 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 從阿里云腳手架創(chuàng)建

適用場景：訪問 Spring 官方倉庫較慢（因網(wǎng)絡原因），阿里云提供了國內(nèi)鏡像，速度更快。

步驟詳解：

打開 IDEA，選擇阿里云腳手架
新建項目時，選擇 Spring Initializr，在右側(cè)的「Server URL」中輸入阿里云腳手架地址：https://start.aliyun.com，點擊「Next」。
配置項目信息
與方式 1 類似，填寫 Group、Artifact 等信息，注意阿里云腳手架可能默認推薦一些國內(nèi)常用依賴（如阿里云 OSS、Druid 等），按需選擇即可。
選擇依賴模塊
核心依賴（如 Spring Web）的選擇與官方腳手架一致，若需使用阿里云生態(tài)的組件（如短信服務、對象存儲），可直接勾選對應依賴。
完成創(chuàng)建并驗證
后續(xù)步驟與方式 1 相同，確認路徑后創(chuàng)建項目，運行主啟動類驗證是否成功。

四、方式 4：Maven 項目改造為 SpringBoot 項目

適用場景：已有 Maven 項目，想在現(xiàn)有基礎(chǔ)上集成 SpringBoot，或希望深入理解 SpringBoot 的依賴結(jié)構(gòu)。

步驟詳解：

創(chuàng)建基礎(chǔ) Maven 項目
打開 IDEA，點擊 File -> New -> Project，選擇 Maven，不勾選任何模板（保持項目純凈），填寫 Group、Artifact 后點擊「Finish」，得到一個空的 Maven 項目。

修改 pom.xml 文件，添加 SpringBoot 依賴
SpringBoot 項目的核心是通過父依賴（spring-boot-starter-parent）統(tǒng)一管理版本和依賴，因此需要在 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>

關(guān)鍵說明：

spring-boot-starter-parent：SpringBoot 的父依賴，定義了常用依賴的版本，避免手動指定版本沖突。
spring-boot-starter-web：Web 開發(fā)的啟動器，自動引入 SpringMVC、內(nèi)嵌 Tomcat 等必要組件。

創(chuàng)建主啟動類
SpringBoot 項目必須有一個標注 @SpringBootApplication 的主啟動類，用于啟動應用。
在 src/main/java 下按包路徑（如 com.itheima）創(chuàng)建類 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(...) 方法是啟動入口，參數(shù)為當前類的 Class 對象。
驗證改造結(jié)果
運行主啟動類的 main 方法，若控制臺輸出 SpringBoot 啟動日志（包含 Started Application in xx seconds），說明改造成功。

總結(jié)與注意事項

版本兼容性：
- SpringBoot 3.x 最低要求 Java 17，若需使用 Java 8，建議選擇 SpringBoot 2.x（如 2.7.15）。
- 依賴版本由父依賴統(tǒng)一管理，無需手動指定，避免版本沖突。
核心要素：
- 無論哪種搭建方式，都需要 spring-boot-starter-parent 父依賴（或等價的依賴管理）。
- 必須有標注 @SpringBootApplication 的主啟動類，這是 SpringBoot 的 “入口”。
選擇建議：
- 新手推薦方式 1 或 3（IDEA 直接創(chuàng)建，簡單高效）。
- 網(wǎng)絡不佳時優(yōu)先選方式 3（阿里云鏡像）。
- 已有 Maven 項目或想深入理解原理，選方式 4。