在IDEA中正确关联JDK源码和文档需确保$JAVA_HOME下存在对应版本的src.zip并准确绑定至SDK的Sourcepath，JDK 17+需配置本地API路径或在线文档，同时验证模块opens、禁用JIT内联优化，并区分完整版与精简版JDK源码支持差异。
如何在IDEA中正确关联JDK源码和文档
IntelliJ IDEA 默认不自动绑定 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+）未被手动删改，否则源码跳转会失效
为什么 attach 源码后仍显示 “Sources not found”
常见于使用自定义 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
调试 JDK 内部类时断点不生效的典型原因
想在 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 调试 JDK 方法行为比看源码更直接
有时不需要进源码，只想验证某个 JDK 方法在特定输入下的返回值或异常，jshell 是最快路径。
立即学习“Java免费学习笔记（深入）”；
- 终端中运行：
jshell --enable-preview
（JDK 14+ 支持预览特性，如record、switch表达式） - 直接调用并观察：
Integer.parseInt("123", 16)→ 输出$1 ==> 291；LocalDateTime.parse("2023-01-01")→ 快速确认格式支持范围 - 配合
/debug命令可查看部分内部调用栈（非全量），比翻src.zip更聚焦实际执行流 - 注意：
jshell使用的是当前JAVA_HOME的 JDK，若想验证多版本行为，需切换环境变量后重开 jshell
