前置条件
- 已安装 VS Code 的核心 Java 插件:
- Extension Pack for Java(Java 扩展包)
- Spring Boot Dashboard(如果是 Spring Boot 项目)
- 已配置好 JDK(推荐 JDK 11+)
针对Spring Boot 项目
Spring Boot 推荐使用 spring-boot-devtools 实现热更新,配置简单且稳定:
步骤 1:添加依赖
在 pom.xml(Maven)或 build.gradle(Gradle)中添加 devtools 依赖:
Maven
<dependencies>
<!-- Spring Boot 热更新依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<!-- 启用 devtools 热更新 -->
<fork>true</fork>
<addResources>true</addResources>
</configuration>
</plugin>
</plugins>
</build>
步骤 2:VS Code 配置
- 打开设置,添加以下配置:
{ // 自动保存(可选,加快热更新) "files.autoSave": "afterDelay", "files.autoSaveDelay": 1000, // Java 自动构建 "java.autobuild.enabled": true, "java.compile.saveActions": "build", // Spring Boot 热更新配置 "spring-boot.ls.enable-live-reload": true, "spring-boot.devtools.restart.enabled": true } - (可选)自定义热更新排除目录
在application.properties/application.yml中配置:# 排除不需要热更新的目录 spring.devtools.restart.exclude=static/**,templates/** # 指定需要监控的目录(可选) spring.devtools.restart.additional-paths=src/main/java
步骤 3:运行项目
- 在 VS Code 中打开「Spring Boot Dashboard」面板
- 右键点击你的 Spring Boot 项目,选择「Run with DevTools」
- 修改代码并保存后,devtools 会自动检测到文件变化,触发热更新(约 1-2 秒生效)
常见问题解决
- 热更新不生效:
- 检查
spring-boot-maven-plugin是否配置了<fork>true</fork>(必须) - 确认 VS Code 的 Java 自动构建已开启
- 重启 VS Code 或重新加载项目
- 检查
- 热更新速度慢:
- 关闭不必要的插件
- 配置
spring.devtools.restart.exclude排除静态资源目录
总结
- Spring Boot 项目:优先使用
spring-boot-devtools,只需添加依赖 + 简单配置即可实现自动热更新。 - 核心关键点:开启 Java 自动构建、Spring Boot 项目需配置
fork=true、确保 devtools 依赖生效。
配置完成后,修改代码并保存,无需手动重启应用,修改内容会自动生效,大幅提升 Java 开发效率。