Cursor中Java项目热部署配置指南

作者：袖梨 2026-06-09

前言

在 Cursor（基于 VS Code）中调试 Spring Boot 时，每次改代码都要手动重启应用，开发效率较低。本文介绍如何配置热部署，实现修改 Java 代码后自动重启，无需手动操作。

一、方案概览

方案	原理	适用场景
Spring Boot DevTools	监听 classpath 变化，自动重启应用	任意代码修改（推荐）
Hot Code Replace (HCR)	JVM 调试器热替换方法体	仅修改方法体
自动编译	保存时自动编译	配合 DevTools 使用

推荐组合：DevTools + 自动编译，实现「保存即热重启」。

二、方案一：Spring Boot DevTools（推荐）

2.1 添加依赖

在 pom.xml 中加入：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

runtime：仅运行时生效，打包时不会打进生产环境
optional：不向依赖本项目的模块传递

2.2 配置 DevTools

在 application.yml 或 application-dev.yml 中：

spring:
  devtools:
    restart:
      enabled: true
      # 排除不需要触发热重启的路径，减少无效重启
      exclude: static/**,public/**,templates/**

2.3 工作机制

DevTools 使用两个 ClassLoader：一个加载依赖，一个加载业务代码
业务代码变更后，只重启业务 ClassLoader，启动速度比完整重启快
依赖未变时，依赖的 ClassLoader 可复用

三、方案二：Hot Code Replace（HCR）

3.1 使用步骤

以 Debug 模式启动应用（F5）
修改某个方法的方法体（不改签名、不增删字段/方法）
保存文件
使用 Ctrl+Shift+F9 或右键 →「Apply Code Changes」应用更改

3.2 限制

只能修改方法体
不能修改方法签名
不能新增/删除方法或字段
不能修改类结构

适合小范围逻辑调整，不适合结构性修改。

四、Cursor / VS Code 配置

4.1 安装扩展

安装 Extension Pack for Java（包含 Java 语言支持、调试、Maven 等）。

4.2 自动编译

在 .vscode/settings.json 中：

{
    "java.compile.nullAnalysis.mode": "automatic",
    "java.autobuild.enabled": true
}

java.autobuild.enabled：保存时自动编译，配合 DevTools 实现热重启

4.3 调试配置

在 .vscode/launch.json 中：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Spring Boot (Debug + 热部署)",
            "request": "launch",
            "mainClass": "com.example.YourApplication",
            "projectName": "your-project-name"
        }
    ]
}

将 mainClass 和 projectName 替换为你的主类和 Maven 模块名。