如何通过Apache POI彻底删除Word文档中的批注及相关引用

你的代码仅移除了段落中的批注范围起始/结束标记，但Word的批注系统包含多个组成部分，遗漏的部分导致无法彻底清除批注：

• 文档级的批注内容节点（CTComment，即主管添加的批注文字）
• 段落中的批注引用标记（CommentReference）
• 表格单元格内段落中的批注（原代码仅遍历了文档顶层段落）

修正后的代码 #

package com.office;

import org.apache.poi.xwpf.usermodel.*;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.*;

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;

public class BookmarkSetter {

    public static void main(String[] args) throws IOException {
        FileInputStream fis = new FileInputStream("f:\\test.docx");
        XWPFDocument document = new XWPFDocument(fis);

        // 处理所有段落：顶层段落 + 表格单元格内的段落
        processAllParagraphs(document);

        // 删除文档中的所有批注内容节点
        CTComments comments = document.getDocument().getBody().getComments();
        if (comments != null) {
            comments.getCommentList().clear();
        }

        // 保存修改
        FileOutputStream out = new FileOutputStream("f:\\test1.docx");
        document.write(out);
        out.close();
        document.close();
        fis.close();
    }

    private static void processAllParagraphs(XWPFDocument document) {
        // 处理顶层段落
        List<XWPFParagraph> paragraphList = document.getParagraphs();
        for (XWPFParagraph paragraph : paragraphList) {
            clearParagraphComments(paragraph);
        }

        // 处理表格中的段落
        List<XWPFTable> tables = document.getTables();
        for (XWPFTable table : tables) {
            List<XWPFTableRow> rows = table.getRows();
            for (XWPFTableRow row : rows) {
                List<XWPFTableCell> cells = row.getTableCells();
                for (XWPFTableCell cell : cells) {
                    List<XWPFParagraph> cellParagraphs = cell.getParagraphs();
                    for (XWPFParagraph p : cellParagraphs) {
                        clearParagraphComments(p);
                    }
                }
            }
        }
    }

    private static void clearParagraphComments(XWPFParagraph paragraph) {
        CTP ctp = paragraph.getCTP();

        // 删除批注范围起始标记
        List<CTMarkupRange> startList = ctp.getCommentRangeStartList();
        for (int i = startList.size() - 1; i >= 0; i--) {
            ctp.removeCommentRangeStart(i);
        }

        // 删除批注范围结束标记
        List<CTMarkupRange> endList = ctp.getCommentRangeEndList();
        for (int i = endList.size() - 1; i >= 0; i--) {
            ctp.removeCommentRangeEnd(i);
        }

        // 删除批注引用标记
        List<CTCommentReference> refList = ctp.getCommentReferenceList();
        for (int i = refList.size() - 1; i >= 0; i--) {
            ctp.removeCommentReference(i);
        }
    }
}

代码说明 #

1. processAllParagraphs方法：遍历文档中所有段落，包括顶层段落和表格单元格内的段落，确保没有遗漏任何位置的批注标记。
2. clearParagraphComments方法：统一清除单段内的三类批注相关标记：范围起始、范围结束、批注引用。
3. 删除文档级批注节点：彻底移除CTComments下的所有CTComment，这才是批注的实际内容存储位置，删除后Word中不会再显示任何批注痕迹。

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