我要评论一、核心说明
本文整理 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 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）：
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 所在包。
- 检查 controller 注解（
以上就是springboot项目新建的五种方式详解的详细内容，更多关于springboot项目新建方式的资料请关注代码网其它相关文章！
发表评论