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，新建项目

• 启动 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：选择稳定版本（如 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。

七、五种方式对比总结

八、常见问题解决

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 所在包。