VS Code中Java项目第三方库导入报错：The import ##### cannot be resolved

问题描述 #

运行Java项目时，工作目录内已存在第三方库的类文件（例如org/apache/pdfbox/pdmodel/PDDocument所在的目录结构），但VS Code持续提示The import ##### cannot be resolved错误。Java核心类（如java.util.ArrayList）导入正常，且多个项目均出现该问题，清理VS Code Java缓存后仍未解决。

解决方案 #

1. 通过Java Projects面板配置构建路径 #

• 按Ctrl+Shift+P输入Java: Show Java Projects调出左侧的「Java Projects」面板
• 右键点击当前项目，选择「Add Library」
• 选择「External JARs or Directories」，定位到存放第三方类文件的根目录（即包含org文件夹的上层目录）并添加
• 等待VS Code完成项目重新索引

2. 手动编辑.classpath文件 #

如果自动配置无效，直接修改项目根目录下的.classpath文件，添加第三方类目录的引用：

<classpath>
    <!-- 保留原有配置内容 -->
    <classpathentry kind="lib" path="你的第三方类文件根目录绝对/相对路径"/>
</classpathentry>

保存文件后，按Ctrl+Shift+P输入Java: Reload Project重新加载项目

3. 检查并更新Java插件 #

• 打开VS Code扩展面板，找到「Language Support for Java by Red Hat」插件，确认是最新版本，若不是则更新后重启VS Code
• 按Ctrl+Shift+P输入Java: Open Java Settings，将「Java > Configuration: Update Build Configuration」设置为automatic

4. 确认JDK版本兼容性 #

第三方库的编译JDK版本与项目当前使用的JDK版本不匹配也会导致识别失败：

• 按Ctrl+Shift+P输入Java: Configure Java Runtime，查看项目关联的JDK版本
• 若第三方库是用低版本JDK编译的，尝试切换项目JDK版本至对应版本

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