如何使用Apache POI移除docx文档中的换行符？

云原生阿岚

2026-8-19

解决DOCX文档换行符删除问题

你的代码只针对内容为\n的段落做删除，但DOCX里的换行分两种核心场景，得分别处理：

1. 删除空白段落（硬换行，按Enter生成的空段落）

空白段落的文本通常不是单纯的\n，而是空字符串或仅含空白字符，修改过滤逻辑即可覆盖：

import java.util.Collections;
import java.util.List;
import java.util.stream.Collectors;

// 筛选所有空白段落（空文本、仅含空格/换行的段落都算）
List<XWPFParagraph> emptyParagraphs = doc.getParagraphs().stream()
    .filter(p -> p.getParagraphText().trim().isEmpty())
    .collect(Collectors.toList());

// *必须反向删除*：正向删除会导致后续段落索引错乱，出现漏删或越界
Collections.reverse(emptyParagraphs);
emptyParagraphs.forEach(p -> {
    int pos = doc.getPosOfParagraph(p);
    if (pos >= 0) {
        doc.removeBodyElement(pos);
    }
});

2. 删除段落内的软换行（Shift+Enter生成的换行符）

这种换行属于段落内部的格式，不是独立段落，需要遍历段落里的文本Run来清理：

for (XWPFParagraph paragraph : doc.getParagraphs()) {
    List<XWPFRun> runs = paragraph.getRuns();
    if (runs == null || runs.isEmpty()) continue;
    
    for (XWPFRun run : runs) {
        String text = run.getText(0);
        if (text != null) {
            // 替换所有换行符（包括\n和\r\n）
            text = text.replaceAll("\\r?\\n", "");
            run.setText(text, 0);
        }
    }
}