在VSCode中使用Apache POI读取Excel(xlsx)时遇包不存在错误求助

DevOps 小满

2026-6-15

解决VSCode手动导入Apache POI后找不到包的问题

你遇到的问题是因为只导入了poi和poi-ooxml的核心jar包，但Apache POI运行需要依赖其他配套jar包，缺一不可。下面是一步步的解决方法，都是新手能看懂的操作：

1. 找到所有需要的POI相关jar包

解压你下载的poi-bin-5.2.3.zip压缩包，里面有3个地方的jar包必须全部导入：

压缩包根目录下：poi-5.2.3.jar、poi-ooxml-5.2.3.jar
lib文件夹里的所有jar文件（比如commons-codec、commons-collections4这类基础工具包）
ooxml-lib文件夹里的所有jar文件（比如处理XML、JSON的依赖包）

别偷懒只挑几个，这些都是POI运行必须的依赖，少一个都可能报错。

2. 在VSCode中添加所有jar到引用库

打开你的Java项目，按以下步骤操作：

点击左侧面板的「JAVA PROJECTS」（如果没显示，按Ctrl+Shift+P输入Java: Show Java Projects调出）
右键点击项目下的「Referenced Libraries」，选择「Add External JARs...」
弹出文件选择框后，找到刚才解压的POI文件夹，把根目录、lib、ooxml-lib里的所有jar文件全选，添加进去

3. 验证是否解决问题

写一段简单的测试代码，确认导入和运行正常：

import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileInputStream;

public class ExcelReaderTest {
    public static void main(String[] args) {
        try (FileInputStream fileInput = new FileInputStream("你的测试文件路径.xlsx");
             Workbook workbook = new XSSFWorkbook(fileInput)) {
            System.out.println("Excel文件读取成功！");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行这段代码，如果控制台输出成功提示，说明问题解决了。