java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot项目新建方式

SpringBoot项目新建的五种方式详解

作者：小王不爱笑132

本文介绍了SpringBoot项目创建的五种主流方式,包括IDEA+Spring官方脚手架、Spring官网下载压缩包、IDEA+阿里云脚手架、阿里云官网下载压缩包和普通MavenJava项目改造为SpringBoot项目,每种方式都有其适用场景、操作步骤、优点和缺点,并总结了五种方式的对比

一、核心说明

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

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

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

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

1. 适用场景

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

2. 操作步骤

步骤 1：打开 IDEA，新建项目

步骤 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 版本和依赖

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

步骤 5：验证项目

3. 优点

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

1. 适用场景

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

2. 操作步骤

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

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

步骤 2：配置项目信息（同方式一）

步骤 3：生成并下载压缩包

步骤 4：解压并导入 IDEA（可选）

步骤 5：验证项目

3. 优点

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

1. 适用场景

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

2. 操作步骤

步骤 1：打开 IDEA，新建项目

步骤 2：配置项目基础信息

同方式一步骤 2（Group、Artifact、Java 版本等），点击「Next」。

步骤 3：选择依赖（阿里云增强）

步骤 4：确认路径并创建

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

步骤 5：验证项目

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

3. 核心优势

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

1. 适用场景

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

2. 操作步骤

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

打开浏览器，访问：https://start.aliyun.com/。

步骤 2：配置项目信息

步骤 3：生成并下载压缩包

步骤 4：解压并使用

步骤 5：验证项目

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

3. 优点

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

1. 适用场景

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

2. 操作步骤

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

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

替换原 pom.xml 内容为以下模板（以 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父工程（核心，统一依赖版本） -->
    <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 主启动类

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：验证项目

3. 核心注意事项

七、五种方式对比总结

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

八、常见问题解决

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

以上就是SpringBoot项目新建的五种方式详解的详细内容，更多关于SpringBoot项目新建方式的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文