一、核心說明

本文整理 SpringBoot 項目創(chuàng)建的 5 種主流方式，涵蓋：

1. IDEA（Spring 官方腳手架）創(chuàng)建
2. Spring 官網(wǎng)下載壓縮包創(chuàng)建
3. IDEA（阿里云腳手架）創(chuàng)建
4. 阿里云官網(wǎng)下載壓縮包創(chuàng)建
5. 普通 Maven Java 項目改造為 SpringBoot 項目

前置條件：已安裝 JDK8+、Maven/Gradle（推薦 Maven）、IDEA（2020 + 版本），網(wǎng)絡通暢（腳手架方式需聯(lián)網(wǎng)）。

二、方式一：IDEA + Spring 官方腳手架創(chuàng)建（最常用）

1. 適用場景

本地開發(fā)、快速初始化、依賴自動管理，適合絕大多數(shù)開發(fā)場景。

2. 操作步驟

步驟 1：打開 IDEA，新建項目

• 啟動 IDEA，點擊「New Project」（若已有項目，點擊「File → New → Project」）。
• 在左側列表選擇「Spring Initializr」，右側確認：
  • SDK：選擇已安裝的 JDK（如 1.8）；
  • Initializr Service URL：默認https://start.spring.io（Spring 官方腳手架地址），保持不變。
  • 點擊「Next」。

步驟 2：配置項目基礎信息

配置完成后點擊「Next」。

步驟 3：選擇 SpringBoot 版本和依賴

• Spring Boot Version：選擇穩(wěn)定版本（如 2.7.x、3.1.x，避免最新快照版）。
• 依賴選擇：根據(jù)需求勾選（如 Web 場景選「Spring Web」，測試選「Spring Boot Starter Test」）。
• 點擊「Next」。

步驟 4：確認項目路徑并創(chuàng)建

• 配置 Project name（默認同 Artifact）、Project location（本地路徑）。
• 點擊「Finish」，IDEA 會自動下載依賴并初始化項目。

步驟 5：驗證項目

• 找到自動生成的主類（如SpringbootDemoApplication），右鍵「Run」。
• 控制臺輸出「Started SpringbootDemoApplication in X seconds」即創(chuàng)建成功。

3. 優(yōu)點

• 可視化配置，無需手動編寫 pom.xml；
• 依賴自動下載，版本與 SpringBoot 適配；
• 自動生成啟動類、配置文件等核心文件。

三、方式二：Spring 官網(wǎng)下載壓縮包創(chuàng)建

1. 適用場景

無 IDEA（僅用文本編輯器）、網(wǎng)絡環(huán)境限制（需離線創(chuàng)建）。

2. 操作步驟

步驟 1：訪問 Spring 官方腳手架

打開瀏覽器，訪問：https://start.spring.io/（Spring Initializr 官網(wǎng)）。

步驟 2：配置項目信息（同方式一）

• 選擇構建工具：Maven/Gradle（推薦 Maven）；
• 選擇語言：Java；
• 配置 Spring Boot 版本、Group、Artifact、Java 版本等（同方式一步驟 2）；
• 點擊「Add Dependencies」添加所需依賴（如 Spring Web）。

步驟 3：生成并下載壓縮包

• 點擊「GENERATE」按鈕，瀏覽器自動下載springboot-demo.zip壓縮包。

步驟 4：解壓并導入 IDEA（可選）

• 解壓壓縮包到本地目錄；
• 打開 IDEA → 「File → Open」 → 選擇解壓后的項目目錄 → 導入。

步驟 5：驗證項目

• 運行主啟動類，控制臺輸出啟動成功日志即可。

3. 優(yōu)點

• 純網(wǎng)頁操作，無需本地 IDE；
• 可離線使用（下載后解壓即可）；
• 依賴配置與官方腳手架一致。

四、方式三：IDEA + 阿里云腳手架創(chuàng)建

1. 適用場景

國內(nèi)網(wǎng)絡環(huán)境（Spring 官方地址可能卡頓）、快速創(chuàng)建適配阿里云的項目。

2. 操作步驟

步驟 1：打開 IDEA，新建項目

• 點擊「New Project」 → 左側選擇「Spring Initializr」；
• 右側修改 Initializr Service URL 為阿里云地址：https://start.aliyun.com；
• SDK 選擇對應 JDK 版本，點擊「Next」。

步驟 2：配置項目基礎信息

同方式一步驟 2（Group、Artifact、Java 版本等），點擊「Next」。

步驟 3：選擇依賴（阿里云增強）

• 阿里云腳手架提供額外適配依賴（如阿里云 OSS、Nacos、RocketMQ 等）；
• 基礎依賴（如 Spring Web）與官方一致，按需勾選后點擊「Next」。

步驟 4：確認路徑并創(chuàng)建

同方式一步驟 4，點擊「Finish」，IDEA 自動下載依賴。

步驟 5：驗證項目

運行主啟動類，啟動成功即完成。

3. 核心優(yōu)勢

• 國內(nèi)訪問速度快，解決官方地址卡頓問題；
• 內(nèi)置阿里云生態(tài)依賴，適配國內(nèi)云服務；
• 版本適配更貼合國內(nèi)開發(fā)場景。

五、方式四：阿里云官網(wǎng)下載壓縮包創(chuàng)建

1. 適用場景

無 IDEA、國內(nèi)網(wǎng)絡環(huán)境、需離線創(chuàng)建阿里云適配項目。

2. 操作步驟

步驟 1：訪問阿里云腳手架官網(wǎng)

打開瀏覽器，訪問：https://start.aliyun.com/。

步驟 2：配置項目信息

• 選擇構建工具（Maven/Gradle）、語言（Java）、Spring Boot 版本；
• 配置 Group、Artifact、Java 版本等基礎信息；
• 點擊「添加依賴」選擇所需依賴（如 Spring Web、阿里云 Nacos 等）。

步驟 3：生成并下載壓縮包

• 點擊「生成項目」按鈕，下載xxx.zip壓縮包。

步驟 4：解壓并使用

• 解壓壓縮包到本地目錄；
• 可直接用文本編輯器編輯，或導入 IDEA（File → Open）。

步驟 5：驗證項目

運行主啟動類，啟動成功即可。

3. 優(yōu)點

• 國內(nèi)訪問快，依賴阿里云生態(tài)；
• 純網(wǎng)頁操作，無需本地 IDE；
• 適合離線開發(fā)或無 IDEA 環(huán)境。

六、方式五：普通 Maven Java 項目改造為 SpringBoot 項目

1. 適用場景

已有普通 Maven Java 項目，需升級為 SpringBoot 項目；學習 SpringBoot 核心配置原理。

2. 操作步驟

步驟 1：創(chuàng)建普通 Maven Java 項目（IDEA）

• 打開 IDEA → 「New Project」 → 左側選擇「Maven」；
• 配置 SDK（JDK），點擊「Next」；
• 配置 Group、Artifact、Version，點擊「Next」；
• 確認路徑后點擊「Finish」，生成空 Maven 項目。

步驟 2：修改 pom.xml，添加 SpringBoot 核心依賴

替換原 pom.xml 內(nèi)容為以下模板（以 SpringBoot 2.7.x 為例）：

<?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父工程（核心，統(tǒng)一依賴版本） -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.15</version> <!-- 穩(wěn)定版本，可替換為3.x -->
        <relativePath/>
    </parent>

    <!-- 基礎配置 -->
    <groupId>com.example</groupId>
    <artifactId>maven-to-springboot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>maven-to-springboot</name>
    <description>Convert Maven project to SpringBoot</description>

    <!-- JDK版本 -->
    <properties>
        <java.version>8</java.version>
    </properties>

    <!-- 核心依賴：Spring Web（web場景） -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 測試依賴（可選） -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <!-- SpringBoot打包插件（必須，否則無法運行jar包） -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.7.15</version> <!-- 與父工程版本一致 -->
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

步驟 3：創(chuàng)建 SpringBoot 主啟動類

• 在src/main/java下創(chuàng)建包（如com.example）；
• 在包下創(chuàng)建主啟動類（如MavenToSpringBootApplication）：

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * SpringBoot主啟動類
 * @SpringBootApplication：核心注解，標識SpringBoot應用
 */
@SpringBootApplication
public class MavenToSpringBootApplication {
    public static void main(String[] args) {
        // 啟動SpringBoot應用
        SpringApplication.run(MavenToSpringBootApplication.class, args);
    }
}

步驟 5：驗證項目

• 運行主啟動類的main方法；

3. 核心注意事項

• 必須添加spring-boot-starter-parent父工程（統(tǒng)一依賴版本）；
• 必須添加spring-boot-maven-plugin打包插件（否則 jar 包無法獨立運行）；
• 主啟動類需放在所有業(yè)務類的上層包（或同層），否則需手動配置掃描路徑；
• @SpringBootApplication注解是核心，整合了@Configuration、@ComponentScan、@EnableAutoConfiguration。

七、五種方式對比總結

八、常見問題解決

1. 依賴下載失敗：
   • 檢查 Maven 鏡像（推薦配置阿里云鏡像）；
   • 確認 SpringBoot 版本與 JDK 兼容（3.x 需 JDK17+，2.x 支持 JDK8+）。
2. 主啟動類運行報錯「找不到主類」：
   • 檢查spring-boot-maven-plugin插件是否添加；
   • 確認主類包路徑與@SpringBootApplication掃描范圍一致。
3. 阿里云腳手架訪問失敗：
   • 檢查網(wǎng)絡，或更換瀏覽器重試；
   • 確認地址為https://start.aliyun.com（非 http）。
4. Maven 改造后接口訪問 404：
   • 檢查 Controller 注解（@RestController/@Controller）；
   • 確認主啟動類包路徑包含 Controller 所在包。

以上就是SpringBoot項目新建的五種方式詳解的詳細內(nèi)容，更多關于SpringBoot項目新建方式的資料請關注腳本之家其它相關文章！

最新評論