在Java中如何配置JDK源码和文档_源码调试与查看说明_技术教程

在IDEA中正确关联JDK源码和文档需确保$JAVA_HOME下存在对应版本的src.zip并准确绑定至SDK的Sourcepath，JDK 17+需配置本地API路径或在线文档，同时验证模块opens、禁用JIT内联优化，并区分完整版与精简版JDK源码支持差异。

IntelliJ IDE

A 默认不自动绑定 JDK 的 src.zip 和 docs.zip，导致 Ctrl+Click 进不去方法、Hover 看不到 Javadoc。关键不是“下载”，而是“路径绑定是否匹配当前 JDK 版本”。

打开 File → Project Structure → SDKs，选中你正在用的 JDK（如 17.0.1）
展开 Sourcepath，点击 +，添加对应版本的 $JAVA_HOME/src.zip（注意：不是 jdk-17/src.zip，而是解压后带完整包结构的原始压缩包）
再展开 Documentation Paths，添加 $JAVA_HOME/docs/api（JDK 17+ 已移除 docs.zip，需用在线 API 或本地构建；JDK 8–16 可用 $JAVA_HOME/docs.zip 解压后填目录）
确认 Classpath 中的 rt.jar（旧版）或 modules-java.base（JDK 9+）未被手动删改，否则源码跳转会失效

常见于使用自定义 JDK（如 Amazon Corretto、Zulu、Liberica）或通过 SDKMAN 安装的 JDK。问题往往出在源码包缺失或路径错位，而非 IDEA 设置本身。

检查 $JAVA_HOME 下是否存在 src.zip：
```
ls $JAVA_HOME/src.zip
```
—— 若无，需手动下载对应构建版本的源码包（例如 Corretto 17.0.10.7 对应 amazon-corretto-17.0.10.7.7-linux-x64-src.zip）
某些精简版 JDK（如 GraalVM CE、jlink 构建的 runtime）根本不含 src.zip，无法 attach 源码，只能换用完整 JDK
IDEA 缓存可能误判：执行 File → Invalidate Caches and Restart → Invalidate and Restart，避免旧索引干扰
Mac 上通过 Homebrew 安装的 OpenJDK（如 openjdk@17）源码默认不安装，需额外运行：
```
brew install openjdk@17 --with-source
```

想在 HashMap.put() 或 String.valueOf() 打断点却跳过？不是代码没走，而是 JIT 编译或内联优化绕过了源码级调试。

启动应用时添加 JVM 参数禁用激进优化：

-XX:-TieredStopAtLevel -XX:+UnlockDiagnosticVMOptions -XX:+DebugNonSafepoints

确保运行配置中勾选了 Enable 'HotSwap' agent 和 Enable debugging of system classes（后者在 Help → Edit Custom VM Options 中加 -Didea.no.system.classes.debug=true 并重启 IDEA）
JDK 9+ 的模块系统限制了对 java.base 等系统模块的调试访问，需在运行配置 VM options 中显式开放：
```
--add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED
```
不要在 static final 字段（如 Integer.MIN_VALUE）或编译期常量表达式上设断点——它们早被内联，不会触发源码行

有时不需要进源码，只想验证某个 JDK 方法在特定输入下的返回值或异常，jshell 是最快路径。