Apache POI 自动调整列宽的坑与解决方案

在使用 Apache POI 操作 Excel 时，我们经常需要自动调整列宽以适应内容。尽管 POI 提供了 Sheet#autoSizeColumn(int column) 方法来自动调整列宽，但在实际应用中可能会遇到一些问题。本文将列举这些坑点，并给出相应的解决方案。

坑点 1：无法自动调整列宽

有时候，即使调用了 autoSizeColumn 方法，列宽也没有变化。这可能是由于单元格中的内容格式问题或单元格边距设置导致的。

解决方案 1：清除格式和边距

在调用 autoSizeColumn 方法之前，确保清除单元格内容的格式和边距。可以使用 CellStyle#clearFormatting() 方法来清除格式，并设置单元格边距为默认值。

示例代码

CellStyle style = workbook.createCellStyle();
style.clearFormatting();
cell.setCellStyle(style);

坑点 2：列宽调整不准确

有时候，autoSizeColumn 方法调整的列宽并不完全准确，导致内容显示不完整或超出单元格范围。

解决方案 2：手动微调列宽

在调用 autoSizeColumn 方法后，可以手动微调列宽，以确保内容完全显示在单元格范围内。可以使用 Sheet#setColumnWidth(int columnIndex, int width) 方法来设置精确的列宽值。

示例代码

sheet.autoSizeColumn(columnIndex);
sheet.setColumnWidth(columnIndex, idealWidth); // 理想的列宽值

坑点 3：大量数据导致的性能问题

当处理大量数据时，连续多次调用 autoSizeColumn 方法可能会影响性能。

解决方案 3：分批处理数据

为了提高性能，可以将数据分批处理，并在每批数据处理完后调用一次 autoSizeColumn 方法。这样可以减少调整列宽的次数，提高处理速度。

示例代码

for (int i = 0; i < data.size(); i++) {
    // 处理数据并设置单元格值
    cell.setCellValue(data.get(i));
    sheet.autoSizeColumn(columnIndex); // 在每次循环末尾调整列宽
}

通过注意这些坑点并采取相应的解决方案，可以更有效地使用 Apache POI 的 autoSizeColumn 方法来自动调整 Excel 列宽，提高代码的健壮性和性能。在处理大量数据或复杂格式时，注意分批处理和手动微调可以避免不必要的问题。