在 IntelliJ IDEA 中为 Java 方法快速生成 Javadoc 注释的最常用方式是光标置于方法签名正上方输入 /** 后按 Enter，IDEA 自动补全参数、返回值等；构造方法、重写方法、字段等同样适用；可自定义模板添加作者、日期等信息。
在 IntelliJ IDEA 中，为 Java 方法快速生成文档注释（即 Javadoc 注释），最常用且高效的方式是使用快捷键 /** + 回车。
光标位置决定生成效果
将光标放在方法签名的正上方（空行或紧贴方法第一行），输入 /** 后按 Enter，IDEA 会自动识别方法参数、返回值、异常等，并生成结构完整的 Javadoc 模板。
- 如果光标在方法内部或下方，可能只生成普通多行注释，不会补全参数说明
- 构造方法、重写方法、接口默认方法同样支持该快捷键
- 字段上使用同样快捷键，会生成带
@see或简要描述的字段注释
自定义 Javadoc 模板（可选增强）
IDEA 允许修改默认生成内容，比如自动添加作者、日期或统一前缀：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 进入 Settings → Editor → File and Code Templates → Includes → File Header
- 在 Other → JavaDoc 模板中编辑，支持 Velocity 语法，例如：
$user$、$date$、$time$ - 保存后，新生成的文档注释就会包含你配置的信息
注意几个常见问题
生成后发现内容不全或格式错乱，多数是因为：
立即学习“Java免费学习笔记（深入）”；
- 方法没有明确的返回类型（如 void 方法误写了返回值）
- 参数名含特殊符号或中文（建议用英文命名，保证解析准确）
- 使用了 Lombok 的
@Getter/@Setter等注解但未启用注解处理器，导致 IDEA 无法识别字段语义
基本上就这些。熟练之后，敲两下回车就能写出规范的文档注释，不复杂但容易忽略细节。
