Apache POI SXSSF生成xlsx：无显示环境下合并单元格适配高度及居中对齐方案

一、动态计算合并单元格高度（适配无显示设备环境） #

在无头环境（如IBM Integration Bus）无法依赖屏幕分辨率的情况下，可通过纯字体属性+文本排版逻辑计算高度，无需调用Toolkit相关API。

核心步骤： #

1. 单位转换规则：
   • Excel行高单位为磅（Point），1磅=1/72英寸
   • Excel列宽默认单位是字符数，需转成磅：默认列宽8.43字符≈64像素，1像素≈0.75磅
2. 文本换行行数计算：
   • 根据合并列的总宽度，结合字体的平均字符宽度，算出每行能容纳的字符数，再统计文本需拆分的行数
   • 若文本含手动换行符\n，需先按换行符分割后累加行数
3. 总高度计算：
   • 单行高度取字体大小的1.2倍（适配默认行间距），总高度=行数×单行高度

代码实现： #

// 计算合并单元格所需高度（支持Times New Roman字体）
public static int calculateMergedHeight(String text, int mergedColCount, Font font) {
    // 1. 计算合并列总宽度（转成磅）
    float defaultColWidthInPoints = 8.43f * 0.75f * 64f / 8.43f; // 默认列宽转磅
    float totalWidth = mergedColCount * defaultColWidthInPoints;
    
    // 2. 计算单字符宽度（Times New Roman 9/11号字体的平均字符宽比例约0.66）
    float charWidth = font.getFontHeightInPoints() * 0.66f;
    int charsPerLine = (int) (totalWidth / charWidth);
    
    // 3. 统计文本总行数（含手动换行）
    String[] lines = text.split("\n");
    int totalLines = 0;
    for (String line : lines) {
        totalLines += (line.length() + charsPerLine - 1) / charsPerLine; // 向上取整
    }
    
    // 4. 计算总高度（行间距按1.2倍字体大小计算）
    return (int) (totalLines * font.getFontHeightInPoints() * 1.2f);
}

// 使用示例
SXSSFWorkbook workbook = new SXSSFWorkbook();
SXSSFSheet sheet = workbook.createSheet();
Font font9 = workbook.createFont();
font9.setFontName("Times New Roman");
font9.setFontHeightInPoints((short)9);

String longText = "这是需要放入合并单元格的长文本，可能包含手动换行\n或者自动换行的内容";
int mergedCols = 3; // 合并3列
int targetHeight = calculateMergedHeight(longText, mergedCols, font9);

// 设置合并单元格并应用高度
CellRangeAddress mergedRegion = new CellRangeAddress(0, 0, 0, mergedCols-1);
sheet.addMergedRegion(mergedRegion);
sheet.createRow(0).setHeightInPoints(targetHeight);

二、实现选中内容居中对齐 #

Apache POI直接支持单元格内容的水平/垂直居中，合并单元格设置样式后，内容会自动在合并区域居中显示。

代码实现： #

SXSSFCellStyle centerCellStyle = workbook.createCellStyle();
// 水平居中
centerCellStyle.setAlignment(HorizontalAlignment.CENTER);
// 垂直居中
centerCellStyle.setVerticalAlignment(VerticalAlignment.CENTER);
// 开启自动换行（配合高度计算使用）
centerCellStyle.setWrapText(true);

// 应用到目标单元格
SXSSFCell cell = sheet.getRow(0).createCell(0);
cell.setCellValue(longText);
cell.setCellStyle(centerCellStyle);

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