Javadoc 在 VSCode 中悬停时不显示

Question

我目前正在使用 VSCode 开发一个 java 项目，当我将鼠标悬停在对象、类型或方法名称上时，文档不再显示。我不知道为什么或者我做了什么来改变这一点。

在下图中，我将鼠标悬停在第一次出现的 ByteBuyUtils 上，正如我们所看到的，没有显示任何内容。

第一个悬停示例

这是在谷歌图片上找到的一张图片，显示了我悬停在某些东西上时想要得到的内容：

悬停代码时我想要的示例

我在 Ubuntu 21.10 上使用 1.65.1 版本的 VSCode。我使用的是 openjdk 版本“18-ea”2022-03-15。

我的 VSCode 上安装了以下扩展：

• Red Hat 对 Java(TM) 的语言支持
• Java 调试器
• Java 测试运行程序

Answer 1

您可以尝试几件事。

行家

如果您使用maven，则需要显式下载项目中包的 javadoc 和源代码。

• 下载源代码：mvn dependency:sources
• 下载javadoc：mvn dependency:resolve -Dclassifier=javadoc

java家庭财产

在vscode中，需要设置java home属性。

• Ctrl+Shift+p打开命令面板
• 搜索user settings json
• 应该settings.json打开
• 添加一个字段java.jdt.ls.java.home并将值设置为 openjdk 包的根文件夹。

对我来说，是/usr/lib/jvm/java-17-openjdk-amd64。所以我添加

"java.jdt.ls.java.home": "/usr/lib/jvm/java-17-openjdk-amd64"

到settings.json.

要找到你的，请尝试

$ which java
/usr/bin/java
$ ls -l /usr/bin/java
......  /usr/bin/java -> /etc/alternatives/java
$ ls -l /etc/alternatives/java
......  /etc/alternatives/java -> /usr/lib/jvm/java-17-openjdk-amd64/bin/java

用 一路向下追踪ls -l。该部分之前的最后一条路径/bin/java是您的JAVA_HOME.

安装openjdk javadoc

您可以doc通过以下方式下载您的 openjdk 版本。apt在Ubuntu上。

$ sudo apt update
$ apt list | grep openjdk-17-

您应该看到openjdk-17-doc并openjdk-17-source可用。更改17为您选择的版本（18例如）。然后

$ sudo apt install openjdk-17-doc openjdk-17-source

最后

重启vscode