在VS Code中引用Apache PDFBox库时出现编译错误

已下载pdfbox-3.0.4.jar放在Java项目根目录，在VS Code通过「Referenced Libraries」添加引用，但编译时出现包不存在、找不到符号的错误，错误信息如下：

merge.java:4: error: package org.apache.pdfbox does not exist
import org.apache.pdfbox.Loader;
^
merge.java:5: error: package org.apache.pdfbox.pdmodel does not exist
import org.apache.pdfbox.pdmodel.PDDocument;
^
merge.java:6: error: package org.apache.pdfbox.pdmodel does not exist
import org.apache.pdfbox.pdmodel.PDPage;
^
merge.java:20: error: cannot find symbol
PDDocument document = Loader.loadPDF(file);
^
symbol: class PDDocument
location: class merge
merge.java:20: error: cannot find symbol
PDDocument document = Loader.loadPDF(file);
^
symbol: variable Loader
location: class merge
merge.java:24: error: cannot find symbol
document.addPage(new PDPage());
^
symbol: class PDPage
location: class merge
6 errors

以下是具体解决步骤：

• 检查VS Code的项目classpath配置
  打开项目根目录下的.classpath文件，确认是否包含PDFBox的引用条目：

  <classpathentry kind="lib" path="pdfbox-3.0.4.jar"/>
  

  若缺失，手动添加该条目后保存，重启VS Code生效。

• 验证JAR包完整性
  重新下载pdfbox-3.0.4.jar，核对文件大小与官方发布的一致，避免因下载中断导致包损坏。

• 命令行编译排查
  用命令行手动指定classpath编译，排除IDE配置问题：

  # Windows系统
  javac -cp .;pdfbox-3.0.4.jar merge.java
  # Linux/macOS系统
  javac -cp .:pdfbox-3.0.4.jar merge.java
  

  若命令行编译成功，说明VS Code的引用库设置未生效，需重新检查IDE的「Referenced Libraries」配置。

• 确认JAR包路径正确性
  确保pdfbox-3.0.4.jar的实际存放路径与添加引用时选择的路径一致。如果JAR包放在子目录（如lib），则.classpath中的路径需改为lib/pdfbox-3.0.4.jar。

• 核对API版本兼容性
  PDFBox 3.x与2.x存在API差异，Loader.loadPDF()是3.x的正确用法，但如果代码基于旧版本编写，需确认没有其他API冲突（当前错误核心为依赖未加载，此点为额外排查项）。

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