OpenJDK 17 Maven项目中VSCode无法显示JDK类文档的解决方法

VSCode 具体解决方案 #

• 确认OpenJDK 17源码包存在
  检查你的OpenJDK 17安装目录，确保根目录下存在src.zip文件。如果没有，重新下载包含源码的OpenJDK 17安装包。

• 配置VSCode Java扩展的运行时路径

  1. 打开VSCode设置（快捷键Ctrl+,），搜索java.configuration.runtimes
  2. 点击编辑 in settings.json，添加JDK 17的配置，明确指定源码包路径：

     "java.configuration.runtimes": [
         {
             "name": "JavaSE-17",
             "path": "/path/to/your/jdk-17",
             "src": "/path/to/your/jdk-17/src.zip",
             "default": true
         }
     ]
     

  3. 保存配置后重启VSCode。

• 校验Maven项目JDK版本配置
  打开项目的pom.xml，确认编译版本与JDK 17一致：

  <properties>
      <maven.compiler.source>17</maven.compiler.source>
      <maven.compiler.target>17</maven.compiler.target>
  </properties>
  

  之后在VSCode侧边栏的Maven面板中点击刷新按钮，重新加载项目配置。

IntelliJ IDEA 参考方案 #

• 打开Project Structure（快捷键Ctrl+Alt+Shift+S）
• 进入SDKs选项，选中已配置的JDK 17
• 切换到Sourcepath标签页，点击+按钮添加JDK目录下的src.zip文件
• 点击Apply保存配置，重启IDEA即可生效

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