IntelliJ IDEA 默认反编译类文件时不会自动显示 JavaDoc，需手动将 JDK 的 src.zip 添加至项目源路径，才能使 Ctrl+点击跳转时同时呈现方法注释与源码结构。
intellij idea 默认反编译类文件时不会自动显示 javadoc，需手动将 jdk 的 `src.zip` 添加至项目源路径，才能使 ctrl+点击跳转时同时呈现方法注释与源码结构。
在 IntelliJ IDEA（包括 Community Edition）中，当你按 Ctrl（macOS 为 ⌘）并点击如 System.out.println() 这样的标准库方法时，IDE 会自动反编译对应 .class 文件并打开。但若未配置 JDK 源码关联，你只会看到纯字节码反编译后的 Java 代码（如 FernFlower 输出），而缺失原始的 JavaDoc 注释、参数说明、@throws 描述等关键文档信息。
要恢复完整的 JavaDoc 支持，请按以下步骤操作：
✅ 正确配置 JDK 源码（src.zip）
打开 File → Project Structure（或使用快捷键 Ctrl+Alt+Shift+S）；
-
在左侧选择 Platform Settings → SDKs；
立即学习“Java免费学习笔记（深入）”；
展开你当前使用的 JDK（例如 17, 21 等），选中 Sourcepath 项；
-
点击右侧 + 号，添加路径：
$JAVA_HOME/src.zip
? 提示：$JAVA_HOME 是你的 JDK 安装根目录（如 C:\Program Files\Java\jdk-21 或 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home）。请确认该路径下确实存在 src.zip 文件（现代 JDK 均默认包含）。
点击 OK 保存设置。
✅ 配置生效后，重新执行 Ctrl+点击（如点击 println），IDEA 将优先尝试加载源码 + JavaDoc —— 此时你不仅能看到反编译逻辑，更会完整显示官方注释，例如：
/**
* Prints a String and then terminates the line. This method behaves as
* though it invokes {@link #print(String)} and then
* {@link #println()}.
*
* @param x The String to be printed.
*/
public void println(String x) {
// ... decompiled body
}⚠️ 注意事项
- 无需额外插件：IntelliJ 内置反编译器（FernFlower / JD-Core）与 JavaDoc 解析完全支持 src.zip，Community 版亦可正常使用；
- 避免重复添加：若 src.zip 已存在于 Sourcepath 列表中，请勿重复添加，否则可能导致索引异常；
- 多 JDK 环境注意：若项目使用了多个 JDK（如 Project SDK 和 Module SDK 不一致），请确保所有相关 SDK 均已配置 src.zip；
- 缓存问题：配置后若仍未显示 JavaDoc，可尝试 File → Invalidate Caches and Restart → Invalidate and Restart，强制刷新符号索引。
? 验证是否成功
将光标置于任意 JDK 类型（如 ArrayList, LocalDateTime）或方法上，按 Ctrl+Q（Quick Documentation）—— 若弹出窗口中包含完整 JavaDoc 内容（含 @param, @return, @see 等标签），即表示配置成功。
通过这一标准配置，你将重新获得与阅读 OpenJDK 源码一致的开发体验：代码可读、文档可达、调试可信。
