Python操作Word实现文本查找替换并在替换词前插入两个空段落

原有逻辑参考 #

原有VBA宏实现规则：

• 查找文本：Pollution
• 替换规则：替换为^p^pChemical，其中^p为Word段落标记，效果是将Pollution替换为Chemical，同时在Chemical前插入2个空段落

替换前效果：

预期替换后效果：

原有代码问题 #

之前编写的代码存在以下逻辑错误，无法实现需求：

• 语法缩进错误，文档初始化语句存在无意义缩进
• 直接对段落对象做in判断，paragraph是对象不是文本内容，需要取.text属性才能获取段落文本
• replace方法未定义，目标词、替换词未加引号作为字符串传入
• add_paragraph默认在文档末尾追加段落，没有指定插入位置，无法实现“在Chemical前插入空段”的效果
• 未处理Word将段落文本拆分为多个run存储的特性，直接遍历run替换容易出现找不到目标词的问题

可运行实现代码 #

from docx import Document

def replace_text_in_para(para, old_str, new_str):
    """替换单个段落内的指定文本，兼容run拆分场景"""
    para_text = para.text
    if old_str not in para_text:
        return False
    # 清空原有所有run的文本
    for run in para.runs:
        run.text = ""
    # 将替换后的文本写入第一个run，保留原有段落格式
    para.runs[0].text = para_text.replace(old_str, new_str)
    return True

# 打开目标文档
doc = Document("Example.docx")

# 倒序遍历段落，避免插入新段落导致索引偏移
for para_idx in range(len(doc.paragraphs) - 1, -1, -1):
    current_para = doc.paragraphs[para_idx]
    if "Pollution" in current_para.text:
        # 替换当前段落内的目标词为Chemical
        replace_text_in_para(current_para, "Pollution", "Chemical")
        # 在当前段落前插入2个空段落
        for _ in range(2):
            empty_para = doc.add_paragraph()
            current_para._element.addprevious(empty_para._element)

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

核心逻辑说明 #

• 倒序遍历段落：从最后一个段落往前遍历，插入新段落时不会影响还未遍历到的前面段落的索引，避免遍历漏判、错判
• 段落内文本替换：先读取段落完整文本做匹配，替换后清空原有run再回写，解决Word自动拆分run导致的目标词匹配失败问题，同时保留原有段落格式
• 精准插入空段落：通过底层XML接口addprevious将新建的空段落直接插入到目标段落（替换后包含Chemical的段落）的前方，插入2次即可得到两个前置空段落的效果，不会出现空段跑到文档末尾的问题

内容的提问来源于stack exchange，提问作者Noob-Programmer