一、核心說(shuō)明

本文整理 SpringBoot 項(xiàng)目創(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 項(xiàng)目改造為 SpringBoot 項(xiàng)目

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

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

1. 適用場(chǎng)景

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

2. 操作步驟

步驟 1：打開 IDEA，新建項(xiàng)目

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

步驟 2：配置項(xiàng)目基礎(chǔ)信息

配置完成后點(diǎn)擊「Next」。

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

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

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

• 配置 Project name（默認(rèn)同 Artifact）、Project location（本地路徑）。
• 點(diǎn)擊「Finish」，IDEA 會(huì)自動(dòng)下載依賴并初始化項(xiàng)目。

步驟 5：驗(yàn)證項(xiàng)目

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

3. 優(yōu)點(diǎn)

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

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

1. 適用場(chǎng)景

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

2. 操作步驟

步驟 1：訪問(wèn) Spring 官方腳手架

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

步驟 2：配置項(xiàng)目信息（同方式一）

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

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

• 點(diǎn)擊「GENERATE」按鈕，瀏覽器自動(dòng)下載springboot-demo.zip壓縮包。

步驟 4：解壓并導(dǎo)入 IDEA（可選）

• 解壓壓縮包到本地目錄；
• 打開 IDEA → 「File → Open」 → 選擇解壓后的項(xiàng)目目錄 → 導(dǎo)入。

步驟 5：驗(yàn)證項(xiàng)目

• 運(yùn)行主啟動(dòng)類，控制臺(tái)輸出啟動(dòng)成功日志即可。

3. 優(yōu)點(diǎn)

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

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

1. 適用場(chǎng)景

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

2. 操作步驟

步驟 1：打開 IDEA，新建項(xiàng)目

• 點(diǎn)擊「New Project」 → 左側(cè)選擇「Spring Initializr」；
• 右側(cè)修改 Initializr Service URL 為阿里云地址：https://start.aliyun.com；
• SDK 選擇對(duì)應(yīng) JDK 版本，點(diǎn)擊「Next」。

步驟 2：配置項(xiàng)目基礎(chǔ)信息

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

步驟 3：選擇依賴（阿里云增強(qiáng)）

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

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

同方式一步驟 4，點(diǎn)擊「Finish」，IDEA 自動(dòng)下載依賴。

步驟 5：驗(yàn)證項(xiàng)目

運(yùn)行主啟動(dòng)類，啟動(dòng)成功即完成。

3. 核心優(yōu)勢(shì)

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

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

1. 適用場(chǎng)景

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

2. 操作步驟

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

打開瀏覽器，訪問(wèn)：https://start.aliyun.com/。

步驟 2：配置項(xiàng)目信息

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

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

• 點(diǎn)擊「生成項(xiàng)目」按鈕，下載xxx.zip壓縮包。

步驟 4：解壓并使用

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

步驟 5：驗(yàn)證項(xiàng)目

運(yùn)行主啟動(dòng)類，啟動(dòng)成功即可。

3. 優(yōu)點(diǎn)

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

六、方式五：普通 Maven Java 項(xiàng)目改造為 SpringBoot 項(xiàng)目

1. 適用場(chǎng)景

已有普通 Maven Java 項(xiàng)目，需升級(jí)為 SpringBoot 項(xiàng)目；學(xué)習(xí) SpringBoot 核心配置原理。

2. 操作步驟

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

• 打開 IDEA → 「New Project」 → 左側(cè)選擇「Maven」；
• 配置 SDK（JDK），點(diǎn)擊「Next」；
• 配置 Group、Artifact、Version，點(diǎn)擊「Next」；
• 確認(rèn)路徑后點(diǎn)擊「Finish」，生成空 Maven 項(xiàng)目。

步驟 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>

    <!-- 基礎(chǔ)配置 -->
    <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場(chǎng)景） -->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

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

    <!-- SpringBoot打包插件（必須，否則無(wú)法運(yùn)行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 主啟動(dòng)類

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

package com.example;

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

/**
 * SpringBoot主啟動(dòng)類
 * @SpringBootApplication：核心注解，標(biāo)識(shí)SpringBoot應(yīng)用
 */
@SpringBootApplication
public class MavenToSpringBootApplication {
    public static void main(String[] args) {
        // 啟動(dòng)SpringBoot應(yīng)用
        SpringApplication.run(MavenToSpringBootApplication.class, args);
    }
}

步驟 5：驗(yàn)證項(xiàng)目

• 運(yùn)行主啟動(dòng)類的main方法；

3. 核心注意事項(xiàng)

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

七、五種方式對(duì)比總結(jié)

八、常見問(wèn)題解決

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

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

最新評(píng)論