iText中单元格拼接字符串出现多余空格问题求助

API 探路者

2026-6-19

解决iText中Cell文本出现多余空格的问题

问题原因

多余空格并非StringBuilder拼接导致，而是iText的默认文本处理逻辑：直接向Cell添加字符串时，iText会自动将其包装为Paragraph对象，而Paragraph会按单词边界规则（比如非字母数字字符与字母的分界）拆分文本，把星号序列和World识别为两个独立"单词"，居中对齐时自动填充空格，最终出现多余空白。

解决方案

方法1：用`Text`对象包裹文本，避免自动分词

将拼接后的字符串用Text包装，让iText将整个文本视为一个整体，不会拆分：

String cellLine = new StringBuilder()  
    .append("*********")
    .append("World")
    .append("***********")
    .toString();

Text text = new Text(cellLine);
Paragraph paragraph = new Paragraph(text)
    .setBold()
    .setTextAlignment(TextAlignment.CENTER);

Cell cell1 = new Cell(1, 3)
    .add(paragraph);

table.addCell(cell1);

方法2：禁用`Paragraph`的分词功能

通过配置Paragraph的属性，禁止文本拆分和连字符处理：

String cellLine = new StringBuilder()  
    .append("*********")
    .append("World")
    .append("***********")
    .toString();

Paragraph paragraph = new Paragraph(cellLine)
    .setBold()
    .setTextAlignment(TextAlignment.CENTER)
    .setHyphenation(null) // 禁用连字符拆分
    .setKeepTogether(true); // 强制文本保持为整体

Cell cell1 = new Cell(1, 3)
    .add(paragraph);

table.addCell(cell1);

方法3：直接设置单元格文本（iText 7+）

部分iText版本支持直接通过setText()跳过Paragraph的自动处理：

String cellLine = new StringBuilder()  
    .append("*********")
    .append("World")
    .append("***********")
    .toString();

Cell cell1 = new Cell(1, 3)
    .setText(cellLine)
    .setTextAlignment(TextAlignment.CENTER)
    .setBold();

table.addCell(cell1);