Python-Docx：如何将文本占位符替换为表格并正确插入文档中间？

你遇到的问题出在doc.add_table()的默认行为——它会把表格直接追加到整个文档的末尾，而非你期望的占位符所在位置。要在指定段落插入表格，需要借助python-docx的底层XML操作来调整表格位置，而不是依赖全局的add_table方法。

修正代码 #

from docx import Document

doc = Document("你的源文档路径.docx")
placeholder = "TEXT_PLACEHOLDER"

for paragraph in doc.paragraphs:
    if placeholder in paragraph.text:
        # 移除段落中的占位符文本
        paragraph.text = paragraph.text.replace(placeholder, "")
        
        # 创建表格（此时表格默认在文档末尾，后续调整位置）
        table = doc.add_table(rows=3, cols=3)
        # 填充表格内容
        for row_idx in range(3):
            for col_idx in range(3):
                table.cell(row_idx, col_idx).text = f"行 {row_idx + 1}, 列 {col_idx + 1}"
        
        # 核心操作：将表格移动到当前段落的紧后方
        paragraph._element.addnext(table._element)

# 保存修改后的文档
doc.save("处理后的文档.docx")

关键说明 #

• paragraph._element是当前段落对应的lxml XML节点，addnext()方法能将表格的XML节点（table._element）插入到该段落节点的后面，确保表格出现在原来占位符的位置。
• 先调用doc.add_table()是为了利用python-docx封装好的API创建规范的表格对象，避免手动拼接XML的复杂度。

如果你的占位符是段落内的一部分（而非整个段落），可以进一步定位到包含占位符的Run对象，删除该Run后再插入表格，但多数场景下上面的代码足够解决问题。

内容的提问来源于stack exchange，提问作者John Wilmer Dela Cerna