本文介绍如何基于pdfbox等专业库，将含表格结构的pdf文件准确转换为excel格式，解决传统文本提取导致列对齐丢失、空列缺失等问题。
将PDF转换为CSV或Excel看似简单，但当PDF中包含真实表格结构时，仅依赖PdfTextExtractor.getTextFromPage()进行换行分割（如原代码所示）会彻底丢失列定位信息——因为PDF本质是图形/流式布局，不是语义化表格。你遇到的 "name some data some data 1" 合并问题，正是由于所有文本被扁平化为一行行字符串，列边界（如竖线、空白间距、字体对齐）未被识别所致。
要真正还原表格结构，必须采用基于坐标的空间分析法：通过解析每个文本片段（TextPosition）的精确x/y坐标、宽度和字体信息，推断列分隔位置，并按列组织数据行。推荐使用 Apache PDFBox 2.0+ 配合自定义TextStripper，或更高效的专用表格提取库：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
✅ 推荐方案：使用 PDFBox + 列边界检测（轻量可控）
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.text.PDFTextStripper;
import org.apache.pdfbox.text.TextPosition;
import java.io.File;
import java.util.*;
public class TableAwarePDFStripper extends PDFTextStripper {
private final List<float> columnXCoords = new ArrayList();
private final Map<integer list>> tableRows = new HashMap();
public TableAwarePDFStripper(List<float> expectedColumns) throws Exception {
super();
this.columnXCoords.addAll(expectedColumns); // 可预先用Foxit/Adobe测量列左边界
}
@Override
protected void writeString(String string, List<textposition> textPositions) throws IOException {
if (textPositions.isEmpty()) return;
// 取首字符x坐标作为行定位基准
float startX = textPositions.get(0).getXDirAdj();
String trimmed = string.trim();
if (trimmed.isEmpty()) return;
// 按最近列边界分组（简化版：找最接近的左侧坐标）
int colIndex = 0;
if (!columnXCoords.isEmpty()) {
float minDist = Float.MAX_VALUE;
for (int i = 0; i new ArrayList(Collections.nCopies(columnXCoords.size(), "")))
.set(colIndex, trimmed);
}
public List<list>> getTableData() {
return tableRows.values().stream()
.filter(row -> row.stream().anyMatch(s -> !s.isEmpty()))
.toList();
}
}</list></textposition></float></integer></float>
? 使用示例（导出为Excel）
public void convertToExcel(String pdfPath, String excelPath) throws Exception {
try (PDDocument doc = PDDocument.load(new File(pdfPath))) {
// 步骤1：手动测量或自动探测列边界（首次可硬编码，如 [50f, 180f, 320f, 450f]）
List<float> columns = Arrays.asList(50f, 180f, 320f, 450f);
TableAwarePDFStripper stripper = new TableAwarePDFStripper(columns);
stripper.setSortByPosition(true); // 关键：保持阅读顺序
stripper.setStartPage(1);
stripper.setEndPage(doc.getNumberOfPages());
stripper.getText(doc); // 触发解析
// 步骤2：写入Excel（使用Apache POI）
try (XSSFWorkbook workbook = new XSSFWorkbook();
FileOutputStream fos = new FileOutputStream(excelPath)) {
XSSFSheet sheet = workbook.createSheet("Extracted Table");
int rowNum = 0;
for (List<string> row : stripper.getTableData()) {
XSSFRow excelRow = sheet.createRow(rowNum++);
for (int i = 0; i <h3>⚠️ 注意事项与进阶建议</h3>
<ul>
<li>
<strong>列边界获取</strong>：首次处理时，可用 Foxit Reader 或 Adobe Acrobat 的“测量工具”标出各列左边缘x坐标；进阶可实现自动列检测（统计所有文本块x坐标的聚类中心）。</li>
<li>
<strong>空单元格处理</strong>：本方案通过预设列数+默认空字符串填充，确保Excel列对齐；若列宽动态变化，需在writeString中动态维护columnXCoords。</li>
<li>
<strong>替代库推荐</strong>：<ul>
<li>
<strong>Tabula</strong>（开源）：专为PDF表格设计，提供CLI/API，支持自动列识别，<a href="https://www.php.cn/link/7421f7613315d16a720f5ad52a4b8b6a" rel="nofollow" target="_blank">https://www.php.cn/link/7421f7613315d16a720f5ad52a4b8b6a</a>；</li>
<li>
<strong>Camelot</strong>（Python生态）：精度高，但需Python环境；</li>
<li>
<strong>pdfplumber</strong>（Python）：底层基于PDFMiner，坐标分析能力极强。</li>
</ul>
</li>
<li>
<strong>避免陷阱</strong>：勿用iText 7的getTextFromPage()直接切分——它不保留位置信息；也慎用正则匹配空格分隔，PDF中空格可能是字体间距而非语义分隔符。</li>
</ul>
<p>最终，<strong>精准表格转换 = 坐标感知 + 列边界建模 + 结构化输出</strong>。从硬编码列宽起步，逐步过渡到动态检测，即可稳定生成与PDF视觉对齐的Excel表格。</p></string></float>
