源码方式安装JDK实为配置官方预编译JDK附带的src.zip与JavaDoc：先验证$JAVA_HOME下是否存在src.zip，缺失则下载匹配版本完整包并复制src.zip至该目录；再下载对应javadoc并配置IDE文档路径；最后调整调试设置允许步入java.*包源码。
源码方式安装 Java JDK 并不是常规做法——JDK 本身是预编译的二进制开发套件，官方不提供“从 Java 源码编译 JDK”的用户级安装路径。所谓“源码方式”，实际是指获取并正确配置 JDK 自带的 src.zip（Java 标准库源码）和离线文档，以便在 IDE 中阅读、调试、注释 JDK 类（如 ArrayList、HashMap），而非自己编译整个 JDK。
确认 JDK 是否已含 src.zip
运行以下命令检查：
-
java -version查看当前版本（例如17.0.2） -
ls $JAVA_HOME/src.zip（Linux/macOS）或dir %JAVA_HOME%\src.zip（Windows）
若提示 “No such file”，说明你安装的是精简版（如 openjdk-17-jdk-headless 或某些包管理器默认安装），需手动补充。
手动添加 src.zip（核心步骤）
这是最常被忽略但最关键的一步：
立即学习“Java免费学习笔记（深入）”；
- 访问与你 JDK 版本完全匹配的发行版官网：推荐 Eclipse Temurin 或 jdk.java.net
- 下载完整构建包（名称含
jdk-*.tar.gz或jdk-*.zip，不含-headless） - 解压后找到根目录下的
src.zip - 将其复制到你当前
$JAVA_HOME目录下（与bin/、lib/同级），路径必须为$JAVA_HOME/src.zip
IDE（IntelliJ、VS Code + Java 插件）重启后会自动识别，无需额外配置。
本地挂载 JavaDoc 文档
src.zip 解决“看源码”，而 JavaDoc 解决“查用法”：
- 在同一发行版页面下载
jdk-*-docs-all.zip（Temurin）或openjdk-*-docs.zip（jdk.java.net） - 解压得到
docs/api/目录，记下其绝对路径（如/opt/jdk-17.0.2/docs/api） - 在 IntelliJ 中：File → Project Structure → SDKs → 选中 JDK → Documentation path → 点 + 添加该路径
- VS Code 中：在设置里搜索
java.configuration.runtimes，为对应 JDK 配置docUrl字段
让调试真正进入 JDK 源码
即使有 src.zip，IDE 默认可能跳过 java.* 包的 step-into。需调整调试设置：
- IntelliJ：Settings → Build, Execution, Deployment → Debugger → Stepping → 去掉勾选 “Do not step into the libraries”，并在 “Skip classes” 列表中移除
java.*相关条目 - 如需修改 JDK 源码并验证（仅学习用），可将
src.zip解压到项目内，并在 IDE 中将项目 SDK 的源码路径指向该文件夹（替代默认 zip）
这样断点进入 String.valueOf() 或 ConcurrentHashMap.computeIfAbsent() 就能直接看到原始实现，还能加自己的注释。
