Cursor 中 Java 项目热部署配置攻略

前言

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

一、方案概览

推荐组合：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 使用步骤

1. 以 Debug 模式启动应用（F5）
2. 修改某个方法的方法体（不改签名、不增删字段/方法）
3. 保存文件
4. 使用 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 模块名。

五、完整使用流程

1. 按 F5 或选择「运行和调试」→ 选择对应配置启动
2. 修改 Java 代码并保存
3. 等待自动编译（右下角会显示编译状态）
4. DevTools 检测到 classpath 变化后自动重启应用

六、常见问题

Q1：修改后没有自动重启？

• 确认 spring-boot-devtools 已加入依赖
• 确认 spring.devtools.restart.enabled 为 true
• 确认已开启 java.autobuild.enabled
• 检查是否在 Debug 模式下启动

Q2：重启太慢？

• DevTools 使用双 ClassLoader，通常比完整重启快
• 可适当调整 exclude，减少不必要的重启
• 生产环境不要引入 DevTools

Q3：生产环境会受影响吗？

• DevTools 使用 optional，不会传递到依赖方
• 打包时通常不会包含 DevTools
• 生产环境建议显式关闭：spring.devtools.restart.enabled=false

七、总结

通过 Spring Boot DevTools + Cursor 自动编译 + 调试配置，可以在 Cursor 中实现：

• 修改 Java 代码后自动编译
• 应用自动重启，无需手动操作
• 调试断点、变量查看等调试能力保持不变

适合日常开发，可明显提升调试和迭代效率。

到此这篇关于Cursor 中 Java 项目热部署配置攻略的文章就介绍到这了,更多相关Java热部署配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论