Python使用python-docx批量修改Word表格中的指定文本

准备条件与核心逻辑

操作前需确认本地已部署Python 3.6及以上环境。核心原理是调用python-docx解析Word文件的DOM结构，将文档转换为可操作的列表对象（doc.tables），随后按行与单元格维度逐层迭代。找到匹配关键词的节点后，直接覆写其纯文本属性即可完成替换，最后导出为新文件以保证原始数据安全。

第1步：安装依赖库

目的：获取支持Office Open XML格式的第三方模块。
动作：在命令行终端执行标准安装指令。

pip install python-docx

第2步：加载源文档并初始化对象

入口：目标Word文件所在绝对或相对路径。
动作：调用Document()构造函数读取文件流，生成可供修改的文档实例。
参数：doc_path（原始文档地址）。

from docx import Document

doc = Document(doc_path)

第3步：遍历表格节点并执行替换

目的：穿透嵌套层级，定位所有含有关键字的单元格。
动作：依次进入tables → rows → cells集合，判断cell.text是否包含搜索词，符合条件则调用replace()进行覆写。
参数：search_text（待替换原文）、replace_text（新内容）。

def replace_in_word_tables(doc_path, save_path, search_txt, replace_txt):
    doc = Document(doc_path)
    
    # 深度遍历所有表格及其内部结构
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                if search_txt in cell.text:
                    cell.text = cell.text.replace(search_txt, replace_txt)
    
    # 风险提醒：直接赋值 cell.text 会清空单元格内的段落与字体样式
    # 若需严格保留粗体/颜色等内联格式，需改用 cell.paragraphs[0].runs[i].text = ... 逐个替换
    doc.save(save_path)

# 实际调用示例
replace_in_word_tables(
    'path_to_your_document.docx',
    'path_to_new_document.docx',
    '需要被替换的文本',
    '替换后的文本'
)

第4步：核对产出文件

完成状态：运行脚本无报错抛出后，检查path_to_new_document.docx是否存在，打开核对关键字段是否已变更，且非目标区域的文字未被意外截断。
操作：确认无误后可按需重命名或归档至业务目录。

注意事项与排错建议

• 格式保护：如代码注释所示，cell.text = ...属于全量重置操作。对于仅需改数字或短词的场景适用；若涉及复杂排版，请务必拆解至run级别进行微操，或先提取原始样式再回填。
• 大文件性能：文档超过50MB或内含数百个复杂嵌套表格时，内存占用会显著上升。建议分批处理或仅过滤指定索引范围。
• 编码兼容性：老旧Doc格式需提前转为Docx，部分含特殊符号或公式编辑器的单元格可能无法被.text属性正确捕获，需人工抽检。

总结

掌握基于python-docx的节点遍历与覆写机制，即可轻松化解日常办公中繁重的表格校对工作。上述流程兼顾了执行效率与安全边界，适配各类常规行政与技术报表的批量修订需求。以上就是Python使用python-docx批量修改Word表格内容的详细内容，更多关于Python自动化处理Office文件的资料请关注本站其它相关文章！