如何使用python-docx替换docx文档中的指定段落或表格为其他文档内容

问题根因 #

你第一次写的替换方法不生效，是因为直接修改Table对象的element属性只是改变了Python层对象的引用指向，并没有实际修改docx文档底层的XML树结构，所以修改不会被保存到最终文件里。
你后续找到的「先删旧表格再插入新表格」的逻辑是可行的，只是没必要额外定位旧表格对应的相邻段落，直接用旧表格本身的节点作为锚点操作即可。

最优实现方案 #

直接基于旧表格的XML节点位置完成替换，无需额外查找段落位置，代码如下：

from docx import Document
from copy import deepcopy

def replace_table(old_table, new_table):
    # 获取新旧表格的底层XML节点
    old_tbl = old_table._tbl
    # 深拷贝新表格节点，避免影响原来源文档
    new_tbl = deepcopy(new_table._tbl)
    # 将新表格插入到旧表格的前一个位置
    old_tbl.addprevious(new_tbl)
    # 从文档树中移除旧表格
    old_parent = old_tbl.getparent()
    old_parent.remove(old_tbl)
    # 清理旧对象引用，避免内存残留问题
    old_table._tbl = old_table._element = None

调用示例

# 打开目标文档和存放新表格的来源文档
target_doc = Document("test.docx")
source_doc = Document("stand.docx")

# 替换目标文档中索引为3的表格（第4个表格，索引从0开始计数）为来源文档的第一个表格
replace_table(target_doc.tables[3], source_doc.tables[0])

# 保存修改后的文档
target_doc.save("替换完成.docx")

补充说明 #

• 该方案完全沿用旧表格的位置，不会改动文档中其他内容的格式和结构
• 必须加deepcopy深拷贝新表格节点，否则会直接把来源文档的节点转移到目标文档，导致来源文档结构损坏

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