Javadoc未显示主因是External JavaDoc路径配置错误，包括URL版本不匹配、本地路径未指向含index.html的根目录、Maven未下载javadoc jar、离线路径格式错误、代理或CORS限制及缓存未刷新。
IDEA里Javadoc没显示，External JavaDoc路径填错是主因
多数人点开类或方法按 Ctrl+Q（Windows）或 Cmd+J（macOS）看到“Documentation not found”，第一反应是网络问题，其实八成是 External JavaDoc 配置指向了无效URL或本地路径。IDEA不会自动校验你填的链接是否真能返回HTML文档，只做静态绑定。
实操建议：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 确认JDK版本与文档版本严格匹配：比如用
jdk-17.0.2，就该配https://docs.oracle.com/en/java/javase/17/docs/api/，而不是/11/或/latest/（后者可能跳转失败或结构不一致） - 本地Javadoc解压后必须含
index.html，且路径填到目录级，不是ZIP文件路径——填/path/to/jdk-17-docs，别填/path/to/jdk-17-docs.zip - 若用Maven项目，优先通过
mvn dependency:sources和mvn dependency:resolve -Dclassifier=javadoc下载源码与Javadoc，再让IDEA自动关联，比手动填URL更稳
Maven依赖的Javadoc无法加载，classifier=javadoc 缺失或仓库未同步
第三方库（如 com.google.guava:guava）的Javadoc默认不随jar包下载，IDEA只会在本地Maven仓库中找到带 -javadoc.jar 后缀的文件才尝试挂载。常见现象是：代码补全正常，但按 Ctrl+Q 仍空白，External JavaDoc 里却显示“Not applicable”。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查本地仓库路径下是否存在对应文件，例如：
~/.m2/repository/com/google/guava/guava/32.1.3-jre/guava-32.1.3-jre-javadoc.jar；没有就说明没下载 - 在IDEA中右键项目 →
Maven → Download documentation，本质是执行mvn dependency:resolve -Dclassifier=javadoc - 某些私有仓库（如Nexus）可能未部署javadoc jar，需联系运维补传，或临时改用中央仓库镜像源
本地Javadoc离线使用时，index.html 路径不对导致404
手动下载的JDK或库文档解压后，如果直接把整个压缩包名当路径填进IDEA，或者路径末尾多加了 /index.html，IDEA会尝试请求类似 file:///path/to/docs/index.html/index.html 这种错误URL，浏览器控制台能看到明确的404。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 路径必须指向文档根目录，即包含
index.html、allclasses-index.html、package-list的那一层文件夹 - Windows下路径用正斜杠或双反斜杠均可，但单反斜杠会被IDEA解析为转义字符，例如
C:docsjdk17是错的，得写成C:/docs/jdk17或C:\docs\jdk17 - Mac/Linux用户注意权限：如果解压后
index.html不可读（chmod -R a+r补一下），Safari或Chrome可能拒绝加载本地file协议页面
在线Javadoc加载慢或超时，Proxy 和 CORS 是隐形拦路虎
即使URL正确、网络通畅，IDEA内嵌浏览器也可能因代理策略或跨域限制卡在“Loading…”。典型表现是：浏览器能打开该URL，但IDEA里始终不渲染，控制台报 Failed to load resource: net::ERR_CONNECTION_TIMED_OUT 或 Blocked by CORS policy。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- IDEA设置里关掉
Use IDE proxy settings for external documentation（Settings → Appearance & Behavior → System Settings → HTTP Proxy），改用系统代理或无代理模式 - 避免使用非标准端口或带查询参数的URL，例如
https://docs.oracle.com/...?v=1可能被拦截；纯路径式URL更可靠 - 某些企业防火墙会拦截对
docs.oracle.com的直接访问，此时只能退回到本地Javadoc方案，别硬扛在线加载
Reload project 或清空 File → Invalidate Caches and Restart，结果以为配置失效，其实是旧缓存还在撑着。 
