如何用python-docx迁移含图片的AlternateContent元素至另一Word文档

由于这类包含wpc（WordProcessingCanvas）的AlternateContent属于嵌入式图形容器，并非普通Run内的图片，无法通过add_picture()直接还原，需要直接操作OpenXML底层结构来完成迁移，具体步骤如下：

1. 从源文档提取AlternateContent XML元素 #

通过python-docx的底层XML对象结合XPath定位并复制目标元素：

from docx import Document
from lxml import etree

source_doc = Document("源文档路径.docx")
target_doc = Document("目标文档路径.docx")

# 遍历源文档段落，定位包含AlternateContent的节点
ac_elem_copy = None
for para in source_doc.paragraphs:
    para_elem = para._p  # 获取段落的底层XML元素
    # 用XPath查找AlternateContent（需匹配命名空间）
    ac_elems = para_elem.xpath(".//w:AlternateContent", namespaces=para_elem.nsmap)
    if ac_elems:
        # 复制元素避免直接引用源文档节点
        ac_elem_copy = etree.ElementTree(ac_elems[0]).getroot()
        break

2. 复制关联媒体并更新rId引用 #

AlternateContent中的blip标签通过r:embed关联媒体文件，需要将源媒体复制到目标文档并替换rId：

def update_media_ref(source_doc, target_doc, ac_elem):
    # 获取源文档的关系管理对象
    source_rels = source_doc.part.rels
    # 定位blip元素及原rId
    blip_elem = ac_elem.xpath(".//a:blip", namespaces=ac_elem.nsmap)[0]
    ns_r = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
    source_rid = blip_elem.get(f"{{{ns_r}}}embed")
    
    # 读取源媒体内容
    source_media_part = source_doc.part.related_parts[source_rid]
    media_content = source_media_part.blob
    media_ext = source_rels[source_rid].target_ext
    
    # 在目标文档中添加媒体并生成新rId
    new_rid = target_doc.part.add_image(media_content, media_ext)
    
    # 更新blip的r:embed属性
    blip_elem.set(f"{{{ns_r}}}embed", new_rid)
    return ac_elem

# 执行媒体引用更新
updated_ac_elem = update_media_ref(source_doc, target_doc, ac_elem_copy)

3. 插入处理后的AlternateContent到目标文档 #

将更新后的XML元素插入到目标文档的指定位置（以段落为例）：

# 选择目标插入段落（示例为最后一段）
target_para = target_doc.paragraphs[-1]
target_para_elem = target_para._p

# 生成新的ID避免冲突（docPr和cNvPr的id需唯一）
new_docpr_id = target_doc.part.next_id
updated_ac_elem.xpath(".//wp:docPr", namespaces=updated_ac_elem.nsmap)[0].set("id", str(new_docpr_id))

new_cnvpr_id = target_doc.part.next_id
updated_ac_elem.xpath(".//pic:cNvPr", namespaces=updated_ac_elem.nsmap)[0].set("id", str(new_cnvpr_id))

# 插入XML元素到目标段落
target_para_elem.append(updated_ac_elem)

# 保存目标文档
target_doc.save("迁移完成文档.docx")

注意事项 #

• 若AlternateContent位于表格单元格、页眉/页脚中，需将遍历对象改为对应底层元素（如单元格的_tc、页眉的_p）
• 若包含多个媒体引用，需遍历所有blip元素逐一处理
• 命名空间需保持与目标文档一致，可通过target_doc.part.element.nsmap获取目标命名空间映射

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