Apache POI(XSSF)：如何通过代码自动适配换行文本行高？

使用Apache POI（XSSF）纯代码生成Excel文件，全程无人工打开或编辑，生成后直接用于后续操作（如转PDF）。部分单元格包含长段落文本，已启用文本换行，但生成的Excel行高未自动扩展，导致内容被截断，仅手动调整行高才能完全显示，而自动化流程中无法人工干预。

代码示例：

CellStyle wrapStyle = workbook.createCellStyle();  
wrapStyle.setWrapText(true);

Row row = sheet.createRow(rowIndex);
Cell cell = row.createCell(colIndex); 
cell.setCellValue(longText);
cell.setCellStyle(wrapStyle);

尽管已启用文本换行，行高仍固定，部分内容被截断。

重要约束：全自动化流程，仅通过代码实现，无人工交互。

已尝试但无效的方案：

• cellStyle.setWrapText(true)
• row.setHeight((short) -1) 或 row.setHeightInPoints(-1)
• 设置固定行高

以上方法均无法像Excel手动自动调整那样可靠扩展行高。

核心疑问：纯代码驱动场景下，能否通过Apache POI编程实现类似Excel的自动行高功能，计算并应用换行文本对应的正确行高？

环境：Java 8、Apache POI（XSSF）、纯代码生成Excel、无人工Excel交互

可以通过以下两种可靠方式实现自动行高适配：

方法1：利用Sheet.autoSizeRow结合列宽预设 #

autoSizeRow方法会根据单元格内容自动计算行高，但前提是列宽已确定（换行后的行数依赖列宽）。步骤如下：

1. 先设置目标列的宽度（可设为固定值或自动适配列宽）
2. 调用autoSizeRow时指定行索引，开启换行适配

示例代码：

// 1. 设置列宽（第colIndex列宽度为25个字符宽度，POI列宽单位为1/256字符宽度）
sheet.setColumnWidth(colIndex, 25 * 256);

// 2. 创建带换行的单元格（原有代码不变）
CellStyle wrapStyle = workbook.createCellStyle();  
wrapStyle.setWrapText(true);
Row row = sheet.createRow(rowIndex);
Cell cell = row.createCell(colIndex); 
cell.setCellValue(longText);
cell.setCellStyle(wrapStyle);

// 3. 自动适配行高，第二个参数true表示考虑换行文本
sheet.autoSizeRow(rowIndex, true);

注意：若需适配多行，循环调用autoSizeRow即可；若列宽需自动适配，可先调用sheet.autoSizeColumn(colIndex)再处理行高。

方法2：手动计算行高（精准控制） #

如果autoSizeRow在特殊场景（如特殊字体、混合格式）下效果不佳，可手动计算文本换行后的行数，结合字体行高得出最终行高：

1. 获取单元格字体，计算单倍行高
2. 根据列宽和文本内容，计算换行后的总行数（含手动换行符\n）
3. 总行数 × 单倍行高（可加少量padding）即为最终行高

示例代码片段：

// 获取字体和列宽
Font font = cell.getCellStyle().getFont();
float fontHeight = font.getFontHeightInPoints();
int columnWidth = sheet.getColumnWidth(colIndex);
// 近似字符宽度（需根据实际字体微调）
float charWidth = font.getFontHeight() / 20;
// 列宽对应的最大可显示字符数（中英文字符宽度有差异，需调整系数）
int maxCharsPerLine = (int) Math.floor((columnWidth / 256) * 1.8);

// 计算换行后的总行数
String text = cell.getStringCellValue();
// 按字符数计算的行数
int lineCount = (int) Math.ceil(text.length() / (double) maxCharsPerLine);
// 加上手动换行符的数量
lineCount += (int) text.chars().filter(c -> c == '\n').count();

// 设置行高，加10% padding避免内容紧贴边框
float rowHeight = lineCount * fontHeight * 1.1f;
row.setHeightInPoints(rowHeight);

提示：若需更精准计算字符宽度，可借助POI结合AWT的FontMetrics工具类实现。

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