Java SpringBoot代码模板精选：高效开发必备指南

要从零开始搭建一个SpringBoot项目，最推荐的做法是直接访问start.spring.io生成项目骨架。版本建议选择3.2.x或3.3.x，填入Group（例如com.example）和Artifact（例如demo-service），勾选spring-boot-starter-web、spring-boot-starter-data-jpa、h2和spring-boot-starter-actuator四个核心依赖，下载后解压，用IDEA打开即可。务必确认pom.xml中保留了spring-boot-starter-parent父声明，否则版本控制会出错，后续依赖冲突、配置失效都是常见坑。

SpringBoot项目快速初始化

打开start.spring.io，Spring Boot版本选3.2.x或3.3.x，Group填com.example，Artifact填demo-service，点击“Generate”下载zip包。解压后用IDEA打开项目根目录，IDE会自动识别为Maven项目并拉取依赖。如果没自动触发，右键pom.xml选择“Reload project”重新加载即可。

引入核心依赖

编辑pom.xml，定位到标签，依次插入以下三个依赖组合——

首先是REST接口开发不可缺少的spring-boot-starter-web，这是所有Web层的基石：

  org.springframework.boot
  spring-boot-starter-web

其次是数据持久化支持，需要配齐spring-boot-starter-data-jpa和h2嵌入式数据库：

  org.springframework.boot
  spring-boot-starter-data-jpa


  com.h2database
  h2

最后是生产级监控与健康检查，引入spring-boot-starter-actuator：

  org.springframework.boot
  spring-boot-starter-actuator

特别提醒：pom.xml中必须保留spring-boot-starter-parent的父声明，否则所有Starter的版本依赖无法自动对齐，JPA自动配置会失效，Actuator端点也可能无法正常暴露。

搭建标准包结构

首先，在src/main/java下创建顶层包com.example.demo（按Group+Artifact拆分）。接着，在这个包下依次建好controller、service、service.impl、repository、entity、dto、config、exception几个子包。然后，在com.example.demo下创建启动类DemoApplication.java，添上@SpringBootApplication注解，类名以Application结尾。最后，检查src/main/resources下的application.yml（推荐YAML格式，别用.properties），配置至少包含：

server:
  port: 8080
spring:
  application:
    name: demo-service

这一步不能少——Spring Boot默认只从classpath:/application.yml加载配置，文件名拼错或放错目录都会导致配置完全读不到。

实现第一个REST接口

在controller包中新建HelloController.java：

@RestController
public class HelloController {
  @GetMapping("/hello")
  public String sayHello() {
    return "Hello from Spring Boot!";
  }
}

写好之后，直接运行DemoApplication的main方法，等控制台输出“Started DemoApplication in X.X seconds”，访问http://localhost:8080/hello，就能看到返回结果。干净利落。