核心是绑定匹配版本的$JAVA_HOME/src.zip至SDK的Sourcepath，而非导入源码工程；JDK 17+需配置本地API路径或在线文档，验证opens模块、禁用JIT内联优化，并区分完整版与精简版JDK源码支持差异。
直接在 IDEA 中关联 JDK 源码，核心是让 IDE 知道“当前用的 JDK 对应哪份 src.zip”，而不是重新导入整个源码工程。只要路径匹配、版本一致、配置到位，Ctrl + 左键就能跳转，Hover 就能看 Javadoc。
确认 JDK 安装目录下有 src.zip
这是前提。执行命令检查：
-
Linux/macOS：
ls $JAVA_HOME/src.zip -
Windows（CMD）：
dir %JAVA_HOME%\src.zip
若不存在，需手动下载对应构建版本的完整源码包（如 Amazon Corretto、Zulu 等发行版需去官网找带 -src.zip 后缀的包）；GraalVM CE 或 jlink 构建的精简版 JDK 默认不含 src.zip，无法关联，必须换用完整版 JDK。
在 Project Structure 中绑定源码路径
打开 File → Project Structure → SDKs，选中你当前项目使用的 JDK（如 17.0.1），展开 Sourcepath：
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 点击 +，添加
$JAVA_HOME/src.zip（注意：不是解压后的文件夹，而是原始未解压的 .zip 文件） - 确保没有重复或错误路径（比如误加了
jdk-17/src.zip这种子目录结构）
再展开 Documentation Paths：
- JDK 8–16：可添加
$JAVA_HOME/docs.zip（解压后填目录路径，或直接用 ZIP 文件） - JDK 17+：官方已移除 docs.zip，建议填入本地构建的 API 文档路径（如
$JAVA_HOME/docs/api），或使用在线文档：https://docs.oracle.com/en/java/javase/17/docs/api/
验证与常见问题处理
关联后测试是否生效：
- 在代码中写
String.valueOf(123)，按住 Ctrl + 左键 —— 应能跳进String.java - 把鼠标悬停在
HashMap上 —— 应显示 Javadoc 内容
若仍提示 “Sources not found”：
- 检查是否用了 SDKMAN / Homebrew 安装的 JDK（如
openjdk@17）：Homebrew 需额外运行brew install openjdk@17 --with-source - IDEA 缓存可能出错：执行 File → Invalidate Caches and Restart → Invalidate and Restart
- 确认 Classpath 中的模块未被手动删改（如误删
modules-java.base）
调试 JDK 内部方法时断点不触发？
这不是源码没关联好，而是 JVM 的 JIT 编译优化导致的。例如在 HashMap.put() 或 String::hashCode 打断点却跳过：
- 在 Run → Edit Configurations → Configuration → VM Options 中添加：
-XX:+UnlockDiagnosticVMOptions -XX:-Inline（禁用内联） - 或启用 Debug → View Breakpoints → Java Method Breakpoint，选择具体方法而非行断点
- 确保模块未被封闭：某些 JDK 17+ 模块默认未 opens，可在
module-info.java中显式声明opens java.util to your.module.name;
