SpringBoot 项目新建的五种方式详细笔记

一、核心说明

本文整理 SpringBoot 项目创建的 5 种主流方式，涵盖：

IDEA（Spring 官方脚手架）创建
Spring 官网下载压缩包创建
IDEA（阿里云脚手架）创建
阿里云官网下载压缩包创建
普通 Maven Java 项目改造为 SpringBoot 项目

前置条件：已安装 JDK8+、Maven/Gradle（推荐 Maven）、IDEA（2020 + 版本），网络通畅（脚手架方式需联网）。

二、方式一：IDEA + Spring 官方脚手架创建（最常用）

1. 适用场景

本地开发、快速初始化、依赖自动管理，适合绝大多数开发场景。

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：配置项目基础信息

参数	说明
Group	组织 ID，如`com.example`
Artifact	项目名 / 模块名，如`springboot-demo`
Name	项目显示名，默认同 Artifact
Description	项目描述（可选）
Package name	包名，默认`Group + Artifact`（如`com.example.springbootdemo`）
Java Version	选择对应 JDK 版本（如 8）
Packaging	打包方式：Jar（推荐，SpringBoot 内置 Tomcat）/ War（需外置容器）
Version	项目版本，默认`0.0.1-SNAPSHOT`

配置完成后点击「Next」。

步骤 3：选择 SpringBoot 版本和依赖

Spring Boot Version：选择稳定版本（如 2.7.x、3.1.x，避免最新快照版）。
依赖选择：根据需求勾选（如 Web 场景选「Spring Web」，测试选「Spring Boot Starter Test」）。
点击「Next」。

步骤 4：确认项目路径并创建

配置 Project name（默认同 Artifact）、Project location（本地路径）。
点击「Finish」，IDEA 会自动下载依赖并初始化项目。

步骤 5：验证项目

找到自动生成的主类（如SpringbootDemoApplication），右键「Run」。
控制台输出「Started SpringbootDemoApplication in X seconds」即创建成功。

3. 优点

可视化配置，无需手动编写 pom.xml；
依赖自动下载，版本与 SpringBoot 适配；
自动生成启动类、配置文件等核心文件。

三、方式二：Spring 官网下载压缩包创建

1. 适用场景

无 IDEA（仅用文本编辑器）、网络环境限制（需离线创建）。

2. 操作步骤

步骤 1：访问 Spring 官方脚手架

打开浏览器，访问：https://start.spring.io/（Spring Initializr 官网）。

步骤 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. 优点

纯网页操作，无需本地 IDE；
可离线使用（下载后解压即可）；
依赖配置与官方脚手架一致。

四、方式三：IDEA + 阿里云脚手架创建

1. 适用场景

国内网络环境（Spring 官方地址可能卡顿）、快速创建适配阿里云的项目。

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：确认路径并创建

同方式一步骤 4，点击「Finish」，IDEA 自动下载依赖。

步骤 5：验证项目

运行主启动类，启动成功即完成。

3. 核心优势

国内访问速度快，解决官方地址卡顿问题；
内置阿里云生态依赖，适配国内云服务；
版本适配更贴合国内开发场景。

五、方式四：阿里云官网下载压缩包创建

1. 适用场景

无 IDEA、国内网络环境、需离线创建阿里云适配项目。

2. 操作步骤

步骤 1：访问阿里云脚手架官网

打开浏览器，访问：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. 优点

国内访问快，依赖阿里云生态；
纯网页操作，无需本地 IDE；
适合离线开发或无 IDEA 环境。

六、方式五：普通 Maven Java 项目改造为 SpringBoot 项目

1. 适用场景

已有普通 Maven Java 项目，需升级为 SpringBoot 项目；学习 SpringBoot 核心配置原理。

2. 操作步骤

步骤 1：创建普通 Maven Java 项目（IDEA）

打开 IDEA → 「New Project」 → 左侧选择「Maven」；
配置 SDK（JDK），点击「Next」；
配置 Group、Artifact、Version，点击「Next」；
确认路径后点击「Finish」，生成空 Maven 项目。

步骤 2：修改 pom.xml，添加 SpringBoot 核心依赖

替换原 pom.xml 内容为以下模板（以 SpringBoot 2.7.x 为例）：

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> <!-- 稳定版本，可替换为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：创建 SpringBoot 主启动类

在src/main/java下创建包（如com.example）；
在包下创建主启动类（如MavenToSpringBootApplication）：

java

运行

复制代码

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父工程（统一依赖版本）；
必须添加spring-boot-maven-plugin打包插件（否则 jar 包无法独立运行）；
主启动类需放在所有业务类的上层包（或同层），否则需手动配置扫描路径；
@SpringBootApplication注解是核心，整合了@Configuration、@ComponentScan、@EnableAutoConfiguration。

七、五种方式对比总结

方式	核心特点	适用场景	优点	缺点
IDEA+Spring 官方	可视化、自动配置、官方标准	主流本地开发	便捷、标准、依赖适配	国内网络可能卡顿
Spring 官网压缩包	纯网页、离线可用、官方标准	无 IDE、离线开发	无环境依赖、跨平台	需手动解压 / 导入
IDEA + 阿里云	国内快、阿里云生态适配	国内开发、阿里云项目	访问快、云生态友好	依赖偏向阿里云生态
阿里云官网压缩包	国内快、纯网页、阿里云适配	无 IDE、国内离线、阿里云项目	访问快、云生态友好	需手动解压 / 导入
Maven 改造	手动配置、理解核心原理	已有 Maven 项目、学习原理	灵活、深入理解 SpringBoot	需手动编写配置，易出错

八、常见问题解决

依赖下载失败 ：
- 检查 Maven 镜像（推荐配置阿里云镜像）；
- 确认 SpringBoot 版本与 JDK 兼容（3.x 需 JDK17+，2.x 支持 JDK8+）。
主启动类运行报错「找不到主类」 ：
- 检查spring-boot-maven-plugin插件是否添加；
- 确认主类包路径与@SpringBootApplication扫描范围一致。
阿里云脚手架访问失败 ：
- 检查网络，或更换浏览器重试；
- 确认地址为https://start.aliyun.com（非 http）。
Maven 改造后接口访问 404 ：
- 检查 Controller 注解（@RestController/@Controller）；
- 确认主启动类包路径包含 Controller 所在包。