Java离线文档需从Oracle官网归档页或OpenJDK社区单独下载jdk-xx-docs-all.zip，解压至无中文无空格路径（如C:/java-docs/jdk-17.0.2），确保根目录含index.html；VSCode中需配置java.doc.location为file:///C:/java-docs/jdk-17.0.2并安装vscode-java-dependency插件，方可实现Ctrl+Click跳转本地HTML文档。
Java离线文档在哪找、怎么解压
官方 JDK 文档（jdk-xx-docs-all.zip）不随 JDK 一起安装，得单独从 Oracle 官网归档页 或 OpenJDK 社区（如 GitHub OpenJDK releases）下载。注意选对版本——JDK 17 的代码用 JDK 17 的文档才匹配，否则 String.isEmpty() 这类方法可能查不到或跳转错行。
下载后解压到一个固定路径，比如 C:java-docsjdk-17.0.2，确保路径不含中文和空格。解压后根目录下必须有 index.html，这是 VSCode 插件识别文档根的依据。
VSCode 要装什么插件才能读 Java 文档
仅靠 Java 扩展包（如 Red Hat 的 redhat.java）无法加载本地 HTML 文档。必须额外安装 Document This 或 Java Doc Viewer 这类辅助插件——但实测下来，最稳定的是 Java Extension Pack 自带的底层能力 + 手动配置 java.configuration.updateBuildConfiguration，再配合浏览器打开方式。
更直接有效的做法是：用 vscode-java-dependency 插件（由 sameertheprogrammer 维护），它支持右键「Open JavaDoc in Browser」并自动定位到当前类/方法。安装后无需额外设置，只要文档路径正确，就能触发跳转。
立即学习“Java免费学习笔记（深入）”；
- 禁用其他文档预览类插件（如
HTML Preview），它们会劫持.html文件打开方式，导致点击跳转失败 - 确认
settings.json中没写死"java.help.server": "online"，这会强制走网络 - 如果用的是 Eclipse JDT LS 后端，检查
java.configuration.runtimes是否把docLocation指向了解压后的文件夹
怎么让 Ctrl+Click 跳转直接打开本地 HTML 页面
VSCode 默认只跳转到源码或 stub，不打开文档页面。要实现「按住 Ctrl 点击 ArrayList 就弹出本地 ArrayList.html」，得靠浏览器协议 + 文件路径映射。
在用户 settings.json 中添加：
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "C:\Program Files\Java\jdk-17.0.2",
"default": true,
"properties": {
"java.home": "C:\Program Files\Java\jdk-17.0.2",
"java.doc.location": "file:///C:/java-docs/jdk-17.0.2"
}
}
]
注意三点：
-
java.doc.location必须是file://协议，Windows 路径斜杠要全用正斜杠，盘符后加三个斜杠（file:///C:/...） - 该路径必须指向解压后含
index.html的根目录，不是api/子目录 - 改完重启 VSCode，且确保 Java 项目用了对应 JRE（Project Settings → Java Compiler → JDK Compliance）
为什么点了跳转却打开空白页或 404
常见原因就三个：路径拼错、插件未生效、浏览器拦截本地 file:// 协议。
先检查控制台：Ctrl+Shift+P → 输入「Developer: Toggle Developer Tools」→ 切到 Console 标签页，把鼠标悬停在类名上，看有没有报 Failed to load resource: net::ERR_FILE_NOT_FOUND。如果有，说明 java.doc.location 指向的路径里根本找不到 java/util/ArrayList.html。
- 手动在资源管理器中拼出完整路径：比如
C:java-docsjdk-17.0.2javautilArrayList.html，能打开就说明路径对；打不开就回去检查解压结构 - 某些新版 Edge/Chrome 默认禁止跨域加载本地 HTML，此时换用 Firefox 或在 Chrome 启动时加参数
--allow-file-access-from-files（不推荐长期使用） - 如果用 Maven 多模块项目，确保每个 module 的
pom.xml里<source></source>和<javadoc></javadoc>插件没覆盖掉全局 doc 配置
真正卡住人的往往不是配置步骤，而是 JDK 版本、文档包版本、VSCode Java 插件版本三者之间存在隐性兼容断层。比如 JDK 21 的文档结构微调过，老版本插件可能解析不了 element-list 文件，这时候就得同步升级 redhat.java 到 v1.35+。
