Apache POI实现单元格内换行但不自动换行的方法

要实现只显示手动插入的换行、同时不让文本自动换行，核心是开启单元格的换行属性，但通过设置足够宽的列宽避免自动换行触发，具体步骤和代码如下：

核心原理 #

LibreOffice/Excel只有在单元格开启WrapText属性时，才会识别并显示单元格内的手动换行符。但开启这个属性后，文本会在超出列宽时自动换行——所以只要让列宽足够容纳单元格内最长的一行文本，就能只保留手动插入的换行，不会触发自动换行。

完整代码示例 #

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFRichTextString;
import java.io.FileOutputStream;
import java.io.IOException;

public class ManualLineBreakDemo {
    public static void main(String[] args) throws IOException {
        // 创建XLSX格式工作簿（如果是XLS用HSSFWorkbook）
        Workbook workbook = WorkbookFactory.create(true);
        Sheet sheet = workbook.createSheet("DemoSheet");

        Row row = sheet.createRow(0);
        Cell cell = row.createCell(0);

        // 用富文本字符串插入手动换行，兼容性更好
        XSSFRichTextString richText = new XSSFRichTextString();
        richText.append("这是第一行较长的文本，用来测试列宽是否足够");
        richText.append("\n"); // 手动插入换行
        richText.append("这是第二行较短的文本");

        cell.setCellValue(richText);

        // 开启单元格换行属性，这是显示手动换行的前提
        CellStyle cellStyle = workbook.createCellStyle();
        cellStyle.setWrapText(true);
        cell.setCellStyle(cellStyle);

        // 设置行高，确保能容纳两行文本
        row.setHeightInPoints(2 * sheet.getDefaultRowHeightInPoints());

        // 调整列宽：POI中列宽单位是1/256个字符宽度，这里设置为能容纳35个左右的字符
        sheet.setColumnWidth(0, 35 * 256);

        // 写入文件
        try (FileOutputStream fos = new FileOutputStream("manual_line_break.xlsx")) {
            workbook.write(fos);
        }
        workbook.close();
    }
}

关键细节说明 #

• 必须开启setWrapText(true)：没有这个属性，无论插入多少换行符，单元格都会把文本显示成一行。
• 列宽设置要精准：根据单元格内最长的一行文本长度调整列宽，确保该行能完全显示，这样就不会触发自动换行。
• 优先用富文本：XSSFRichTextString的换行处理比普通字符串的\r\n更稳定，在LibreOffice中的兼容性更好。

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