使用python-docx替换段落文本时，如何妥善处理页眉/页脚中的图片？

直接赋值paragraph.text会清空段落内所有非文本元素（包括图片），因为这个操作会重置整个段落的内容结构，替换成仅包含新文本的单个run。要保留图片，你可以直接操作段落的XML底层节点，只修改文本内容而保留其他元素：

实现代码 #

import re

def replace_text_preserve_images(paragraph, find_text, replace_text):
    find_pattern = re.compile(re.escape(find_text), re.IGNORECASE)
    # 获取段落的XML根节点
    p_xml = paragraph._p
    
    # 遍历所有文本节点进行替换
    for node in p_xml.iter():
        if node.tag.endswith('t'):  # 匹配Word文本节点标签
            if node.text:
                node.text = find_pattern.sub(replace_text, node.text)

使用示例 #

把你原来的替换逻辑替换成这个函数调用即可：

# 替代原来的paragraph.text = modified_paragraph
replace_text_preserve_images(paragraph, find.entryWord, replace.entryWord)

原理说明 #

• python-docx的段落元素底层是Word的XML结构，图片等非文本内容以独立的XML节点（如<w:drawing>）存在，和文本节点<w:t>并列。
• 直接遍历并修改<w:t>节点的文本内容，不会触动其他节点，因此能保留图片、格式等元素。
• 用正则表达式的IGNORECASE标志实现大小写不敏感匹配，和你原代码的逻辑一致。

注意事项 #

如果待替换的文本被拆分在多个<w:t>节点中（比如跨不同格式的run），这个方法无法处理跨节点的匹配——但这和你原代码的局限性一致，原代码同样无法处理跨run的文本替换。

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