intellij idea 没有官方或主流的 docgenerator 插件，该名称多为对 document assistant、smart-doc 或内置 javadoc 功能的误称；真实可用方案包括：1. document assistant（spring rest 接口 markdown 文档生成）；2. smart-doc（maven/gradle 插件，支持 openapi 等多格式）；3. idea 内置 javadoc 工具（支持预览与 html 导出）。
IntelliJ IDEA 本身没有叫 DocGenerator 的官方插件，也没有主流社区广泛使用的同名插件。你看到的这个名字，大概率是混淆了几个真实存在的工具：可能是对 Document Assistant、Smart-Doc 或 IDEA 内置 JavaDoc 功能的误称，也可能是某个小众或已下架插件的旧名。
为什么搜不到 DocGenerator 插件？
在 IntelliJ IDEA 的插件市场（JetBrains Marketplace）中搜索 DocGenerator，结果为空或仅返回零星几个无人维护、下载量低于 100 的实验性插件。这说明它不具备稳定性、兼容性或实际使用基础。真实可用的文档生成方案集中在以下三类：
-
Document Assistant：专为 Spring MVC@RestController方法生成 Markdown 文档，依赖代码结构和注释，不生成 HTML 或 PDF -
Smart-Doc：Maven/Gradle 插件，通过扫描源码生成 OpenAPI、HTML、Markdown 等格式，与 IDEA 无直接集成，但可通过 External Tools 调用 - IDEA 内置 JavaDoc 工具：基于标准 Javadoc 注释，支持一键预览、导出 HTML，无需额外插件
想快速生成接口文档？优先用 Document Assistant
如果你的项目是 Spring Boot + @RestController 风格，这是最轻量、最贴合编辑器流程的方案：
- 安装后，在任意
@RestController类的方法名上右键 →Generate→Generate API Doc - 它会自动提取
@GetMapping路径、@RequestParam/@RequestBody参数、@ApiResponse注释，并生成带表格和示例 JSON 的 Markdown 片段 - 注意：不支持深度嵌套对象（如 A → B → A 循环引用），会抛
StackOverflowError；字段层级建议控制在 3 层以内 - 必须确保方法所在类有
@RestController（不是@Controller），且项目已正确加载 Spring 依赖
需要标准 JavaDoc 或对接 CI？绕过插件，用 IDEA 内置功能
对于普通 Java 项目，别折腾插件——IDEA 自带的 Javadoc 支持足够可靠：
- 光标放在类/方法上，按
Ctrl Q（Windows/Linux）或F1（macOS）即可实时预览解析后的 Javadoc - 菜单栏
Tools → Generate JavaDoc…，可指定输出路径、编码、可见范围（如仅 public）、是否包含 UML 图等 - 生成过程调用的是本地 JDK 的
javadoc命令，兼容性由 JDK 版本决定，不受 IDEA 升级影响 - 若需在 Maven 构建中自动触发，直接配置
maven-javadoc-plugin，无需任何 IDEA 插件参与
真正容易被忽略的点是：文档生成效果高度依赖注释质量。哪怕用了 Document Assistant，如果参数没写 @param、返回值没写 @return、异常没写 @throws，生成的文档就只剩空表格和默认占位符。与其花时间找一个名字像模像样的插件，不如先统一团队的 Javadoc 编写规范。
