IntelliJ IDEA 实现保存即编译需三步协同：1. 开启 Settings → Compiler → Build project automatically；2. 在 Registry 中启用 compiler.automake.allow.when.app.running；3. 校准模块 Output path 与构建路径一致（如 Maven 项目应为 target/classes）。

IntelliJ IDEA 默认不自动编译 Java 项目，必须手动开启 “Build project automatically” 并配合 Registry 中的 compiler.automake.allow.when.app.running 才能真正实现保存即编译（尤其在调试时）。

开启 Build project automatically

这是自动编译的前提开关，但仅开启它还不够——IDEA 默认只在显式触发构建（如 Ctrl+F9）时编译，不会响应文件保存。

• 进入 Settings/Preferences → Build, Execution, Deployment → Compiler，勾选 Build project automatically
• 该选项本身不生效于运行中项目，仅影响手动构建行为；若未配合 Registry 设置，保存 Java 文件后 class 文件不会更新
• Mac 用户注意：该设置路径为 IntelliJ IDEA → Preferences → Build, Execution, Deployment → Compiler

启用 Registry 中的 automake 开关

真正让 IDEA 在保存、切换焦点或调试中实时编译的关键，是启用隐藏的 Registry 选项。否则 Build project automatically 几乎无感。

• 按下 Ctrl+Shift+A（Win/Linux）或 Cmd+Shift+A（Mac），输入 Registry... 并打开
• 找到并勾选 compiler.automake.allow.when.app.running（名称含 “allow when app running”）
• 无需重启 IDEA，立即生效；此时保存 .java 文件后几秒内，对应 .class 就会刷新（可观察 out/production/xxx 或 build/classes 目录）
• 该选项关闭时，即使在 Debug 模式下修改代码，也需手动 Ctrl+F9 才能热更 —— 这是绝大多数人卡住的地方

确认编译输出路径与模块配置一致

自动编译生效了，但 class 文件没出现在预期位置？大概率是模块（Module）的 Output path 和实际构建路径错位，导致 IDE 找不到新 class 去热替换。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

立即学习“Java免费学习笔记（深入）”；

• 右键项目根目录 → Open Module Settings（或 F4）→ Modules → Sources 标签页，检查 Output path 是否指向正确目录（如 Maven 项目应为 target/classes）
• 若使用 Maven，确保未勾选 Use module compile output path（该选项会覆盖 Maven 的 target 路径，导致编译结果被写到 out/ 下，而 Spring Boot 等框架运行时只读 target）
• Gradle 项目同理：在 Settings → Build, Execution, Deployment → Gradle 中确认 Build and run using 和 Run tests using 都设为 Gradle，而非 IntelliJ IDEA

调试时热更新失败的常见原因

即使上述全开，Debug 时修改代码仍提示 “Hot swap failed”，往往不是自动编译问题，而是 JVM 热替换能力限制。

• 仅支持方法体内部修改（如改逻辑、加日志），不支持新增/删除字段、方法签名变更、新增类等 —— 此时 IDEA 会灰掉 Reload changed classes 按钮
• 确认运行配置中 On 'Update' action 和 On frame deactivation 都设为 Update classes and resources（非 Update resources only）
• 某些框架（如 Lombok）需额外开启 annotation processor：在 Settings → Build, Execution, Deployment → Compiler → Annotation Processors 中勾选 Enable annotation processing

自动编译看似开关一开就完事，但真正起效依赖三个独立环节协同：IDE 编译开关 + Registry 隐藏策略 + 模块输出路径对齐。漏掉任意一个，都会表现为“保存了却没编译”或“编译了却没热更”。