
刚学Spring Boot那会儿我对着空荡荡的IDEA界面发愣——明明网上教程那么多真到自己动手时还是不知道第一个文件该建在哪里。后来踩的坑多了才发现从零搭建一个项目真正卡住新手的往往不是代码本身而是环境、依赖、配置这些“周边”环节。这篇文章就把这些环节一次讲清楚照着走一遍你手里就会有一个能跑起来的项目。先把环境准备好Spring Boot对Java版本有明确要求。如果你用的是Spring Boot 3.xJDK最低需要17推荐直接用21。还在用JDK 8的话选择Spring Boot 2.7.x也可以但新项目建议直接上3.x。构建工具选Maven。IDEA旗舰版自带Spring Boot项目创建向导社区版则需要手动新建Maven模块再自己往pom.xml里加依赖。IDEA中检查Maven配置打开Settings确认本地仓库路径正确建议配好国内镜像源否则第一次下载依赖会等很久。创建项目骨架打开IDEAFile → New → Project左侧选择Spring Initializr。需要填的信息不多Group填公司或组织域名倒序比如com.exampleArtifact项目名比如demoTypeMavenJava选17或21PackagingJar点击Next进入依赖选择。初期只需要勾选Spring Web它能提供Web接口和内置Tomcat。顺手把Lombok也勾上省去大量getter/setter代码。点击CreateMaven开始下载依赖。第一次会比较慢泡杯茶的功夫就好了。配置文件从properties换成yml项目创建后resources目录下默认是application.properties。建议改名为application.ymlYAML的层级结构更直观。一个基础配置大概长这样yaml复制下载spring: application: name: demo server: port: 8123 servlet: context-path: /api这段配置做了三件事给项目起名指定端口8123以及给所有接口加/api前缀。开发阶段建议加上DevTools。在pom.xml中引入spring-boot-devtools依赖后修改代码保存即可自动重启。IDEA中还需要勾选Build project automatically否则自动重启不会生效。代码放对位置后面少折腾Spring Boot不强制目录结构但按分层来组织代码后期维护会轻松很多。标准的四层结构如下controller——接收前端请求把数据交给service。类名以Controller结尾。service——业务逻辑都在这里。接口放在service目录下实现类放在service/impl子目录命名加Impl后缀。daoMapper——数据库操作。MyBatis的XML文件放在resources/mapper下对应子路径。entity——数据库表的实体类属性与字段保持一致。实体类上加上Lombok的Data注解编译时自动生成getter、setter和toString代码量能减少一大半。跑起来验证一下在controller包下新建一个类java复制下载RestController public class HelloController { GetMapping(/hello) public String hello() { return Hello, Spring Boot!; } }启动项目控制台出现Started DemoApplication字样就说明成功了。浏览器访问http://localhost:8123/api/hello能看到返回内容一个完整的Spring Boot项目就跑通了。从环境准备到接口测试核心步骤其实就这么些。真正花时间的往往是环境配置和依赖下载这些“前戏”。把这篇放在手边下次开新项目直接从“创建项目骨架”开始省下来的时间留给写业务逻辑。