如何在Apache POI HWPF处理的.doc文档表格单元格中插入换行符

问题根因 #

旧版二进制.doc格式中，Word定义了专属的内部换行标记规则，\n、\r\n、系统换行符这类普通文本换行符不会被HWPF识别为格式指令，只会被判定为不可打印字符，最终在文档中显示为空白方框。

可行解决方案 #

方案1：插入Word软换行对应特殊字符 #

如果需要的是单元格内软换行（对应Word操作的Shift+Enter效果），直接拼接Word专属软换行标记\u000b即可：

cell.insertBefore("Test \u000b Test");

方案2：调用HWPF API插入段落换行 #

如果需要的是段落级换行（对应Word操作的Enter效果），使用Range的insertBreak方法实现：

// 插入第一部分文本
cell.insertBefore("Test ");
// 插入段落换行标记
cell.getRange().insertBreak(BreakType.PARAGRAPH);
// 插入第二部分文本
cell.insertAfter(" Test");

注意事项 #

• 建议升级Apache POI到4.1.2及以上稳定版本，旧版本HWPF存在部分单元格格式处理bug
• 不要尝试通过文本替换、拼接普通换行符的方式实现，这类操作均不会被HWPF解析为有效换行

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