本文详解如何在 intellij idea（含 community 版）中恢复对 jdk 反编译类（如 printstream.class）的 javadoc 显示，核心是正确配置 jdk 源码包 src.zip 到项目源路径。
本文详解如何在 intellij idea（含 community 版）中恢复对 jdk 反编译类（如 printstream.class）的 javadoc 显示，核心是正确配置 jdk 源码包 src.zip 到项目源路径。
在 IntelliJ IDEA 中按 Ctrl（Windows/Linux）或 Cmd（macOS）点击 JDK 类（如 System.out.println()），默认应跳转至反编译的 .class 文件，并同步显示 JavaDoc 注释（如方法说明、参数含义、异常列表等）。若仅看到纯字节码反编译结果而缺失文档，通常并非插件或缓存问题，而是 JDK 配置中缺少关联的源码支持。
IDEA 的反编译器（如内置 FernFlower）本身不生成 JavaDoc；它依赖 JDK 安装目录下的 src.zip 文件 提供原始注释。当该文件未被正确挂载到 JDK 配置中时，IDE 就无法将反编译代码与对应 JavaDoc 关联，导致悬停提示和跳转视图中 JavaDoc 消失。
✅ 正确配置步骤（适用于 IDEA 2021.3+ 及 Community 版）
- 打开 File → Project Structure → SDKs（或直接按 Ctrl+Alt+Shift+S）；
- 在左侧列表中选中你当前项目使用的 JDK（例如 17, 21）；
- 展开右侧的 Sourcepath 节点；
- 点击 + 号，选择 JAR or directory；
- 浏览并定位到 JDK 安装目录下的 src.zip 文件（典型路径示例）：
- Windows: C:\Program Files\Java\jdk-17\src.zip
- macOS: /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/src.zip
- Linux: /usr/lib/jvm/java-17-openjdk-amd64/src.zip
- 点击 OK 保存配置，重启 IDEA（或刷新项目）即可生效。
? 验证是否成功：再次按住 Ctrl 点击 println()，进入 PrintStream.class 后，将鼠标悬停在方法名上——此时应立即显示完整 JavaDoc（含 @param, @return, @throws 等）；同时，在编辑器右侧的 Quick Documentation（Ctrl+Q）中也能查看富文本格式文档。
⚠️ 注意事项与常见误区
- 不要混淆 javadoc.jar：javadoc.jar 仅用于生成外部 HTML 文档，IDEA 不使用它渲染内联 JavaDoc；必须使用 src.zip（含 .java 源文件及原始注释）。
- Community 版完全支持：此功能为 IDE 内置能力，无需额外插件（如 “JavaDoc” 或 “Enhanced Decompiler”），默认 FernFlower 即可解析 src.zip 中的注释。
- 多 JDK 环境需逐个配置：若项目切换多个 JDK（如 11/17/21），每个 SDK 均需单独绑定对应的 src.zip。
- Gradle/Maven 项目不影响此配置：该设置属于 IDE 级别 SDK 元数据，与构建工具无关；即使使用 --no-sources 下载依赖，JDK 自身源码仍需手动挂载。
- 若 src.zip 不存在：请重新下载完整版 JDK（如从 Adoptium 或 Oracle），精简版（JRE 或某些 Docker 镜像）通常不含 src.zip。
完成上述配置后，所有 JDK 标准类（java.*, javax.*, sun.* 等）的反编译视图将恢复完整的 JavaDoc 支持，大幅提升源码级调试与 API 理解效率。这是 IntelliJ 对 Java 开发者最基础也最关键的体验保障之一。
立即学习“Java免费学习笔记（深入）”；
