Ubuntu系统下VS Code无法正常显示Javadoc如何解决？

该问题由Java语言服务未正确关联JDK源码与Javadoc附件导致，即便安装Java Extension Pack，也会因Ubuntu OpenJDK默认组件缺失、配置路径错误、缓存异常，出现悬停标准库方法仅显示空代码片段的问题，按以下步骤操作即可修复：

• 补装OpenJDK源码组件
  Ubuntu默认通过apt安装的OpenJDK不会自动携带源码包，终端执行命令安装当前使用JDK版本的源码组件，以JDK17为例：
  sudo apt update && sudo apt install openjdk-17-jdk openjdk-17-source
  若使用JDK11、JDK21等其他版本，将命令里的版本号替换为对应版本即可。安装完成后源码包默认存放在/usr/lib/jvm/[对应JDK文件夹名]/lib/src.zip路径下。
• 手动配置VS Code Java运行时关联
  1. 按Ctrl+,打开VS Code设置，搜索java.configuration.runtimes，点击「在settings.json中编辑」
  2. 在配置项中添加对应JDK的根路径、源码路径、Javadoc关联地址，参考配置如下：

  "java.configuration.runtimes": [
    {
      "name": "JavaSE-17",
      "path": "/usr/lib/jvm/java-17-openjdk-amd64",
      "sources": "/usr/lib/jvm/java-17-openjdk-amd64/lib/src.zip",
      "javadoc": "file:///home/your_username/docs/jdk17-api/",
      "default": true
    }
  ]
  

  3. 若不清楚本地JDK实际安装路径，终端执行sudo update-alternatives --config java查看输出的路径，去掉末尾的/bin/java即为JDK根目录，替换上述配置里path和sources字段的对应路径即可。有联网需求的可将javadoc字段替换为对应JDK版本的官方公开文档地址，离线环境提前下载对应版本Javadoc压缩包解压到本地后，填写本地file协议路径即可正常加载。
• 清理语言服务缓存重载
  按Ctrl+Shift+P调出命令面板，搜索执行Java: Clean Java Language Server Workspace命令，在弹出的确认框中选择重启，等待右下角Java语言服务索引进度加载完成后，再悬停Math.ceil等标准库方法即可正常显示完整Javadoc内容。

避坑提示：配置运行时不要指向JRE目录，必须选择完整JDK根目录，否则语言服务无法读取源码包，只能解析出空的方法签名片段。

内容的提问来源于stack exchange，提问作者eternal_white