如何使用Apache XWPF库在DOCX指定占位符位置插入表格？

可以实现，核心是定位到占位符所在段落的位置，在其紧邻位置插入表格，而非直接调用默认的createTable()（默认会将表格添加到文档末尾）。以下是具体实现方案：

核心逻辑 #

• 定位包含目标占位符的段落和文本运行（Run）
• 清除占位符文本
• 获取该段落在文档中的索引位置
• 在该索引的下一个位置插入新表格

修正后的完整代码 #

for (XWPFParagraph paragraph : document.getParagraphs()) {
    boolean placeholderFound = false;
    for (XWPFRun run : paragraph.getRuns()) {
        String text = run.getText(0);
        if (text != null) {
            // 先处理其他文本替换逻辑
            for (Map.Entry<String, String> entry : data.entrySet()) {
                if (entry.getValue() != null) {
                    text = text.replace(entry.getKey(), entry.getValue());
                }
            }
            if (text.equals(placeholder)) {
                // 移除占位符文本
                run.setText("", 0);
                placeholderFound = true;
                break; // 找到占位符后跳出Run循环，处理段落级插入
            } else {
                // 保留原有换行处理逻辑
                String[] lines = text.split("\n");
                if (lines.length > 1) {
                    run.setText("", 0);
                    run.setText(lines[0], 0);
                    for (int i = 1; i < lines.length; i++) {
                        run.addBreak();
                        run.setText(lines[i], i);
                    }
                } else {
                    run.setText(text, 0);
                }
            }
        }
    }
    if (placeholderFound) {
        // 获取当前段落的位置索引
        int paraIndex = document.getPosOfParagraph(paragraph);
        // 创建示例表格（可自定义行列数）
        XWPFTable table = document.createTable(3, 3);
        // 填充表格示例内容（可选）
        for (int rowIdx = 0; rowIdx < table.getNumberOfRows(); rowIdx++) {
            XWPFTableRow row = table.getRow(rowIdx);
            for (int cellIdx = 0; cellIdx < row.getTableCells().size(); cellIdx++) {
                XWPFTableCell cell = row.getCell(cellIdx);
                cell.setText(String.format("行%d列%d内容", rowIdx+1, cellIdx+1));
            }
        }
        // 将表格插入到占位符段落的下一个位置
        CTTbl cttbl = table.getCTTbl();
        document.getDocument().getBody().insertNewTbl(paraIndex + 1);
        document.getDocument().getBody().setTblArray(paraIndex + 1, cttbl);
        break; // 找到占位符后停止循环，避免重复处理
    }
}

关键细节说明 #

• document.getPosOfParagraph(paragraph)：获取目标段落在文档中的索引位置，是精准插入的核心
• insertNewTbl(paraIndex + 1)：在目标段落的下一个位置创建空表格节点
• setTblArray(paraIndex + 1, cttbl)：将创建好的表格内容替换到空节点中，完成指定位置插入
• 必须先清除占位符文本，避免残留无效内容

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