HotCodeReplace 默认禁用，需在 .vscode/settings.json 中配置 "java.debug.settings.hotCodeReplace": "auto" 才生效；仅支持方法体内修改，类结构、字段、签名变更均失败，且依赖 JVM 处于暂停态或安全点。
HotCodeReplace 在 VSCode Java 项目中默认是禁用的，必须显式配置为 auto 或 manual 才能生效；且它只替换方法体，改类结构、字段、签名都会失败。
确认调试器已加载并支持 HCR
不是所有 Java 调试场景都支持热替换。只有通过 launch.json 启动的本地调试会话（"type": "java"），且 JVM 是标准 HotSpot（非 GraalVM native-image 等）时，HCR 才可用。
- 确保安装了最新版
Debugger for Java（由 Red Hat 提供，包含在Extension Pack for Java中） - 打开项目根目录（含
pom.xml或build.gradle），否则redhat.java语言服务器不会启动，HCR 按钮和配置项都不出现 - 调试前先按
F5启动一次，确认左下角状态栏显示 “Debugging” —— 这表示调试器已连接到 JVM，HCR 功能才就绪
设置 hotCodeReplace 为 auto 模式
auto 模式会在你保存 Java 文件后自动触发替换，无需手动点按钮，但前提是修改合法（仅限方法体）。
- 在项目根目录的
.vscode/settings.json中添加：{"java.debug.settings.hotCodeReplace": "auto"} - 不要写成
"java.debug.settings.enableHotCodeReplace": true—— 这个键名已废弃，VSCode 会忽略 - 如果全局设置和工作区设置冲突，以工作区（即项目内
.vscode/settings.json）为准 - 改完保存后，右下角可能弹出 “Hot Code Replace succeeded” 提示；失败则提示 “Hot code replace failed: …”（常见原因见下一条）
哪些修改会触发失败？常见错误现象
HCR 不是热部署，它依赖 JVM 的 JVMTI 接口做运行时类重定义（redefineClasses），限制极严。以下操作必然失败：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 新增或删除一个
public void doSomething()方法 → 报错java.lang.UnsupportedOperationException: class redefinition failed: attempted to add a method - 给已有类加一个字段
private String name;→ 同样报attempted to add a field - 把
String getName()改成int getName()（改返回类型）→ 方法签名变更，不被允许 - 在
main方法里加断点后修改其内部逻辑，但没保存文件 →auto模式不会触发，必须先Ctrl+S - 使用 Lombok 的
@Data且启用了lombok.addLombokGeneratedAnnotation = true→ 生成的 getter/setter 被视为“Lombok-generated”，HCR 可能拒绝替换整个类
Spring Boot 项目别只靠 HCR
如果你改的是 Controller 层逻辑，又希望页面刷新立刻看到效果，hotCodeReplace 往往不够用 —— 它不重启 Spring 上下文，不扫描新注解，也不刷新 Thymeleaf 模板。
- 真正适合“改完即生效”的组合是：
spring-boot-devtools+java.autobuild.enabled: true -
devtools会监听classes/目录变化，触发整个 WebApplicationContext 重启（毫秒级），比 HCR 更彻底 - HCR 适合：正在调试一个长生命周期服务（如消息监听器、定时任务），不想中断其运行，只微调某段处理逻辑
- 二者可共存：HCR 处理方法内逻辑，
devtools应对结构性改动 —— 但别同时开启autoHCR 和频繁保存，容易因类加载冲突导致 JVM 报ClassNotFoundException
最易被忽略的一点：HCR 成功的前提是 JVM 必须处于「暂停态」或「刚执行完一次方法」—— 如果线程卡死在某个无限循环或阻塞 I/O 中，保存代码后也不会触发替换，得先让线程走到安全点。这时候手动点一下调试工具栏的 Apply Code Changes 按钮（或 Ctrl+Shift+F9）反而更可靠。
