必须确认JDK版本匹配且src.zip真实有效：执行unzip -l $JAVA_HOME/src.zip | head -n 5验证含java/lang/String.java等路径；在IDEA中File→Project Structure→SDKs→Sourcepath直接添加src.zip文件（非解压目录），置顶并确保rt.jar或modules-java.base未被删改。
能关联，但必须确认你用的 JDK 版本是否自带 src.zip，且路径没被 IDEA 误读或缓存干扰。
确认 src.zip 真的存在且匹配当前 JDK
很多人点开 $JAVA_HOME 目录看到 src.zip 就以为万事大吉，其实它可能：
- 是空包（某些 Corretto/Zulu 构建漏打了源码）
- 版本错位（比如你用的是 jdk-17.0.10+7，但 src.zip 来自 17.0.9+6）
- 被 IDE 识别为“不完整结构”（比如压缩包里没有 java/lang/Object.java 这类顶层路径）
执行这行命令验证：
unzip -l $JAVA_HOME/src.zip | head -n 5
输出应包含类似 java/awt/Component.java 或 java/lang/String.java 的路径。如果只看到 src/ 一级目录，说明是错误打包的源码包，不能直接 attach。
在 IDEA 中正确绑定 src.zip 而不是解压后目录
IDEA 支持直接挂载 .zip 或 .jar 作为 source path，不需要手动解压——解压反而容易出问题（路径层级错、编码乱、无法热更新）。关键操作是：
- 打开
File → Project Structure → SDKs，选中你当前项目使用的 JDK（如17.0.10） - 展开
Sourcepath，点击+，**直接添加$JAVA_HOME/src.zip文件本身**（不是解压后的文件夹） - 确保该条目排在
Sourcepath列表最上方（IDEA 按顺序查找，靠后会被忽略） - 不要勾选 “Extract sources to project”，这是给第三方库用的，对 JDK 源码无效
如果你用的是 Homebrew 安装的 openjdk@17，路径通常是：/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home/src.zip（Mac）或 /usr/lib/jvm/java-17-openjdk-amd64/src.zip（Debian/Ubuntu）。
为什么 Ctrl+Click 还跳不到、Hover 不显示 Javadoc
常见原因不是设置错了，而是底层机制被绕过：
-
rt.jar（JDK 8）或modules-java.base（JDK 9+）被手动从Classpath删除——恢复默认即可 - 用了
jlink构建的精简 runtime（如 GraalVM CE、某些 CI 镜像），src.zip根本不存在，只能换完整版 JDK - IDEA 缓存了旧的索引：执行
File → Invalidate Caches and Restart → Invalidate and Restart - JDK 是 Amazon Corretto/Zulu/Liberica 等定制版，需去官网单独下载对应构建号的
-src.zip包（例如corretto-17.0.10.7.7-linux-x64-src.zip），不能混用 OpenJDK 官方包
JDK 17+ 没有 docs.zip 怎么办
从 JDK 17 开始，Oracle/OpenJDK 不再提供 docs.zip，$JAVA_HOME/docs 目录已移除。替代方案只有两个：
- 在
Documentation Paths中填入在线地址：https://docs.oracle.com/en/java/javase/17/docs/api/（推荐，自动更新） - 本地构建离线文档：用
javadoc --module-source-path $JAVA_HOME/src.zip -d ./jdk17-docs --module java.base，然后填路径./jdk17-docs（耗时长，适合无网络环境）
注意：在线文档路径必须以 / 结尾，否则 IDEA 会报 Unable to locate documentation。
最常被忽略的一点：JDK 模块系统（JPMS）下，某些内部 API（如 sun.misc.Unsafe）即使有源码，IDEA 默认也不允许跳转——需要在 module-info.java 中显式 opens 或用 --add-opens 启动参数，否则 Ctrl+Click 会静默失败。
