如何解决VSCode使用Apache POI运行Java时的NoClassDefFoundError

你遇到的java.lang.NoClassDefFoundError报错有两个明确的诱因：

1. Apache POI不是独立运行的组件，本身依赖大量第三方工具库，你只导入了POI自身的jar包，缺失了它强制依赖的commons-io库。报错中提到的org.apache.commons.io.output.UnsynchronizedByteArrayOutputStream类仅在commons-io 2.8.0及以上版本提供，如果你导入了旧版本的commons-io也会触发该报错。
2. VSCode中将jar包加入「Referenced Libraries」仅保证编译期类路径正确，若运行配置的类路径未包含/lib下的所有依赖包，就算你已经把依赖放进/lib目录，运行时依然会找不到类。

• 第一步：补全POI所需依赖
  如果你选择手动管理jar包，除POI的核心jar（poi、poi-ooxml）外，需要将对应版本的所有依赖包全部下载放入/lib目录，必须包含的依赖有：commons-io 2.8.0+、commons-codec、commons-collections4、xmlbeans、poi-ooxml-lite（或全量poi-ooxml-full）。如果不想手动核对依赖版本，建议改用Maven或Gradle管理项目依赖，工具会自动拉取所有传递依赖，不会出现漏包、版本不匹配问题。
• 第二步：修正运行时类路径配置
  打开项目下.vscode/launch.json文件，找到你当前使用的Java运行配置项，添加如下配置确保/lib下所有jar都被纳入运行时类路径：

  "classPaths": [
      "${workspaceFolder}/lib/*.jar"
  ]
  

  若项目中没有launch.json文件，按F5选择Java运行时会自动生成该配置文件，修改对应字段即可。
• 第三步：清理缓存重新运行
  按Ctrl+Shift+P（Mac系统为Command+Shift+P）打开命令面板，执行Java: Clean Java Language Server Workspace命令，重启Java语言服务后重新编译运行项目即可。

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