使用iText7设置单元格宽度遇问题：无空格文本不自动换行

核心问题原因 #

当单元格内是无空格的连续字符串时，iText默认不会自动拆分文本，加上表格默认使用自动布局模式（会根据内容调整单元格宽度），导致你设置的setWidth(25)被忽略。

解决方案代码示例 #

// 先确保表格设置为固定布局模式，强制遵守单元格宽度
Table table = new Table(UnitValue.createPercentArray(columNames.length));
table.setWidth(UnitValue.createPercentValue(100)); // 表格占满可用宽度
table.setFixedLayout(); // 关键：启用固定布局，严格遵循单元格宽度

for(String columnName : columNames) {
    Paragraph paragraphCell = new Paragraph(columnName);
    paragraphCell.setFont(font);
    paragraphCell.setFontSize(10);
    paragraphCell.setTextAlignment(TextAlignment.CENTER);
    
    // 允许无空格文本自动断字换行
    // 英文文本用断字规则
    paragraphCell.setHyphenation(new HyphenationConfig("en", "US", 2, 2));
    // 中文文本可启用任意字符拆分
    // paragraphCell.setSplitCharacters(new DefaultSplitCharacters(true));
    
    Cell celda1 = new Cell();
    celda1.add(paragraphCell);
    celda1.setWidth(UnitValue.createPointValue(25)); // 明确设置固定点值
    table.addHeaderCell(celda1);
}

关键修改点说明 #

• 表格启用固定布局：调用table.setFixedLayout()，让表格严格按照预设的单元格宽度渲染，不再根据内容自动调整。
• 段落启用文本拆分：
  • 英文场景：用HyphenationConfig设置断字规则，参数分别为语言、地区、前导字符数、尾随字符数，确保长单词在合适位置拆分。
  • 中文场景：用DefaultSplitCharacters(true)允许在任意字符处拆分换行，适配中文无空格的排版逻辑。
• 明确宽度单位：使用UnitValue.createPointValue(25)替代直接传数字，避免单位歧义（iText默认单位为点，明确指定更稳妥）。

额外注意事项 #

• 若表格按百分比设置宽度，单元格也可使用百分比宽度，比如celda1.setWidth(UnitValue.createPercentValue(20))，配合固定布局同样生效。
• 确保使用的字体支持目标语言字符，否则可能出现换行异常或乱码。

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