🌐 Spring Initializr 详细步骤
2
配置项目基本信息
- Project: Maven Project / Gradle Project
- Language: Java / Kotlin / Groovy
- Spring Boot: 2.7.x (选择稳定版本)
- Group: com.example
- Artifact: demo
- Name: demo
- Package name: com.example.demo
- Packaging: Jar / War
- Java: 8 / 11 / 17
3
选择依赖
常用的Starter依赖：
- Spring Web: 构建Web应用
- Spring Data JPA: 数据持久化
- MySQL Driver: MySQL数据库驱动
- Spring Security: 安全框架
- Spring Boot DevTools: 开发工具
4
生成并下载项目
点击"GENERATE"按钮，下载生成的项目压缩包
5
导入IDE
解压项目文件，使用IDE导入Maven/Gradle项目
💻 IntelliJ IDEA 创建步骤
1. 新建项目
File → New → Project
2. 选择Spring Initializr
左侧选择"Spring Initializr"
3. 配置项目信息
- Server URL: https://start.spring.io
- 填写项目基本信息
4. 选择依赖
根据需要选择相应的Starter
5. 完成创建
IDE自动下载依赖并配置项目
💡 IDEA小技巧
可以在创建项目时直接配置Git仓库，方便版本管理
⌨️ SpringBoot CLI 创建步骤
基本语法：
spring init [options] [location]
常用参数：
-d, --dependencies: 指定依赖-g, --groupId: 指定groupId-a, --artifactId: 指定artifactId-v, --version: 指定版本-p, --packaging: 指定打包方式-j, --java-version: 指定Java版本
创建示例：
spring init --dependencies=web,data-jpa,mysql --groupId=com.example --artifactId=demo my-project
查看可用依赖：
spring init --list
📁 项目结构解析
my-spring-boot-project/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/demo/
│ │ │ ├── DemoApplication.java
│ │ │ ├── controller/
│ │ │ ├── service/
│ │ │ ├── repository/
│ │ │ └── entity/
│ │ └── resources/
│ │ ├── application.properties
│ │ ├── static/
│ │ └── templates/
│ └── test/
│ └── java/
│ └── com/example/demo/
│ └── DemoApplicationTests.java
├── pom.xml
├── mvnw
├── mvnw.cmd
└── README.md
核心文件说明：
DemoApplication.java
SpringBoot应用的主启动类，包含main方法和@SpringBootApplication注解
application.properties
应用配置文件，用于配置数据库连接、端口号等信息
pom.xml
Maven项目配置文件，定义项目依赖、插件和构建配置
static/
存放静态资源文件，如CSS、JavaScript、图片等
⚙️ 主启动类详解
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
@SpringBootApplication注解作用：
- @Configuration: 标识配置类
- @EnableAutoConfiguration: 启用自动配置
- @ComponentScan: 组件扫描
📝 配置文件示例
application.properties:
server.port=8080
server.servlet.context-path=/api
spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.com.example.demo=DEBUG
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} - %msg%n
application.yml (YAML格式):
server:
port: 8080
servlet:
context-path: /api
spring:
datasource:
url: jdbc:mysql://localhost:3306/demo
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
jpa:
hibernate:
ddl-auto: update
show-sql: true
properties:
hibernate:
format_sql: true
logging:
level:
com.example.demo: DEBUG
pattern:
console: "%d{yyyy-MM-dd HH:mm:ss} - %msg%n"
❗ 常见问题解决
问题1：项目无法启动
原因：端口被占用或配置错误
解决：检查端口配置，修改application.properties
问题2：依赖下载失败
原因：网络问题或Maven配置问题
解决：配置Maven镜像源，检查网络连接
问题3：IDE无法识别项目
原因：项目导入方式错误
解决：使用"Import Project"导入Maven项目
💡 调试技巧
- 查看控制台日志信息
- 检查Maven依赖是否正确下载
- 确认Java版本兼容性
- 验证SpringBoot版本与依赖版本匹配
🎯 最佳实践
项目命名规范：
- 使用小写字母和连字符
- 避免使用特殊字符
- 名称要有意义和描述性
依赖选择建议：
- 只添加必要的依赖
- 选择稳定版本
- 注意依赖之间的兼容性
项目结构建议：
- 遵循Maven标准目录结构
- 按功能模块组织代码
- 保持包结构清晰
🏆 推荐配置
初学者建议使用Spring Initializr + IntelliJ IDEA的组合，简单高效