使用Apache POI复制Word页眉页脚丢失样式问题求助

问题根源 #

你当前使用setHeaderFooter直接替换页眉页脚XML结构的方式存在缺陷：页眉页脚内的文本样式（段落样式、字符样式等）依赖于文档的样式库，模板文档里的样式ID在目标文档中不存在时，Word会自动用默认样式替代，导致格式混乱。_getHdrFtr()获取的内部XML里的样式引用是模板独有的，目标文档无法识别这些ID，自然丢失样式。

解决方案 #

需要分两步处理：

1. 先将模板文档的样式库同步到目标文档
2. 逐段复制页眉页脚的内容（含文本和样式），而非直接替换整个页眉页脚对象

代码实现 #

1. 同步文档样式库

private static void copyStyles(XWPFDocument target, XWPFDocument template) {
    // 复制段落样式
    template.getStyles().getParagraphStyles().forEach(style -> {
        if (target.getStyles().getStyle(style.getStyleId()) == null) {
            target.createStyle().setStyle(style.getCTStyle());
        }
    });
    // 复制字符样式
    template.getStyles().getCharacterStyles().forEach(style -> {
        if (target.getStyles().getStyle(style.getStyleId()) == null) {
            target.createStyle().setStyle(style.getCTStyle());
        }
    });
    // 复制表格样式（页眉页脚含表格时需保留）
    template.getStyles().getTableStyles().forEach(style -> {
        if (target.getStyles().getStyle(style.getStyleId()) == null) {
            target.createStyle().setStyle(style.getCTStyle());
        }
    });
}

2. 复制页眉内容（页脚逻辑同理）

private static void copyHeaderContent(XWPFHeader targetHeader, XWPFHeader templateHeader) {
    // 清空目标页眉原有内容
    targetHeader.getParagraphs().forEach(p -> targetHeader.removeParagraph(p));
    
    // 逐段复制模板页眉段落
    templateHeader.getParagraphs().forEach(templatePara -> {
        XWPFParagraph targetPara = targetHeader.createParagraph();
        // 复制段落样式
        targetPara.getCTP().setPPr(templatePara.getCTP().getPPr());
        
        // 复制段落内每个文本Run
        templatePara.getRuns().forEach(templateRun -> {
            XWPFRun targetRun = targetPara.createRun();
            targetRun.setText(templateRun.getText(0));
            // 复制字符样式和格式
            targetRun.getCTR().setRPr(templateRun.getCTR().getRPr());
        });
    });
    
    // 复制页眉内的表格（无表格可删除此段）
    templateHeader.getTables().forEach(templateTable -> {
        XWPFTable targetTable = targetHeader.createTable();
        targetTable.getCTTbl().setTblPr(templateTable.getCTTbl().getTblPr());
        templateTable.getRows().forEach(templateRow -> {
            XWPFTableRow targetRow = targetTable.createRow();
            templateRow.getTableCells().forEach(templateCell -> {
                XWPFTableCell targetCell = targetRow.getCell(templateRow.getTableCells().indexOf(templateCell));
                targetCell.getCTTc().setTcPr(templateCell.getCTTc().getTcPr());
                copyCellParagraphs(targetCell, templateCell);
            });
        });
    });
}

// 辅助方法：复制表格单元格内的段落
private static void copyCellParagraphs(XWPFTableCell targetCell, XWPFTableCell templateCell) {
    targetCell.getParagraphs().forEach(p -> targetCell.removeParagraph(p));
    templateCell.getParagraphs().forEach(templatePara -> {
        XWPFParagraph targetPara = targetCell.addParagraph();
        targetPara.getCTP().setPPr(templatePara.getCTP().getPPr());
        templatePara.getRuns().forEach(templateRun -> {
            XWPFRun targetRun = targetPara.createRun();
            targetRun.setText(templateRun.getText(0));
            targetRun.getCTR().setRPr(templateRun.getCTR().getRPr());
        });
    });
}

3. 整合后的页眉页脚复制方法

public static void copyHeaderFooter(XWPFDocument targetDocument, XWPFDocument templateDocument) {
    // 第一步：同步样式库
    copyStyles(targetDocument, templateDocument);
    
    // 获取模板页眉页脚
    XWPFHeader templateHeader = templateDocument.getHeader(HeaderFooterType.DEFAULT);
    XWPFFooter templateFooter = templateDocument.getFooter(HeaderFooterType.DEFAULT);
    
    // 创建目标页眉页脚
    XWPFHeader targetHeader = targetDocument.createHeader(HeaderFooterType.DEFAULT);
    XWPFFooter targetFooter = targetDocument.createFooter(HeaderFooterType.DEFAULT);
    
    // 复制页眉内容
    if (templateHeader != null) {
        copyHeaderContent(targetHeader, templateHeader);
    }
    
    // 复制页脚内容
    if (templateFooter != null) {
        copyFooterContent(targetFooter, templateFooter);
    }
}

// 页脚内容复制方法（逻辑同页眉）
private static void copyFooterContent(XWPFFooter targetFooter, XWPFFooter templateFooter) {
    targetFooter.getParagraphs().forEach(p -> targetFooter.removeParagraph(p));
    
    templateFooter.getParagraphs().forEach(templatePara -> {
        XWPFParagraph targetPara = targetFooter.createParagraph();
        targetPara.getCTP().setPPr(templatePara.getCTP().getPPr());
        
        templatePara.getRuns().forEach(templateRun -> {
            XWPFRun targetRun = targetPara.createRun();
            targetRun.setText(templateRun.getText(0));
            targetRun.getCTR().setRPr(templateRun.getCTR().getRPr());
        });
    });
    
    templateFooter.getTables().forEach(templateTable -> {
        XWPFTable targetTable = targetFooter.createTable();
        targetTable.getCTTbl().setTblPr(templateTable.getCTTbl().getTblPr());
        templateTable.getRows().forEach(templateRow -> {
            XWPFTableRow targetRow = targetTable.createRow();
            templateRow.getTableCells().forEach(templateCell -> {
                XWPFTableCell targetCell = targetRow.getCell(templateRow.getTableCells().indexOf(templateCell));
                targetCell.getCTTc().setTcPr(templateCell.getCTTc().getTcPr());
                copyCellParagraphs(targetCell, templateCell);
            });
        });
    });
}

注意事项 #

• 同步样式库是核心，确保目标文档能识别模板页眉页脚中的样式引用
• 逐段、逐Run复制能完整保留原有的段落格式和字符格式
• 若页眉页脚不含表格，可删除表格相关复制代码

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