嘿，这个报错太常见了——你肯定是直接把整个Document实例当成可迭代对象来遍历了，比如写了for item in doc:这种代码对吧？

为什么会报错？ #

用python-docx（最常用的Python操作Word库）时，Document对象本身并不是可迭代的。它只是整个文档的容器，你得明确指定要遍历的具体内容集合，比如段落、表格、章节这些。

怎么修复？ #

根据你要修改的内容类型，选择对应的可迭代属性：

• 要处理段落：用doc.paragraphs（返回文档中所有段落的列表）
• 要处理表格：用doc.tables（返回文档中所有表格的列表）
• 要处理章节/页眉页脚：用doc.sections，再通过章节对象访问header/footer的段落

举个实际的修改例子：

错误代码（会触发报错）

from docx import Document

doc = Document("my_document.docx")
# 错误：直接遍历Document对象
for content in doc:
    print(content.text)

正确代码（修改段落文本）

from docx import Document

doc = Document("my_document.docx")

# 遍历所有段落并修改指定文本
for para in doc.paragraphs:
    if "需要替换的旧文本" in para.text:
        para.text = para.text.replace("需要替换的旧文本", "新的替换文本")

# 如果要处理表格内容
for table in doc.tables:
    for row in table.rows:
        for cell in row.cells:
            cell.text = cell.text.replace("表格旧内容", "表格新内容")

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

额外提示 #

如果你的文档包含页眉、页脚或者文本框这类特殊内容，需要单独处理：

• 页眉内容：doc.sections[0].header.paragraphs（第一个章节的页眉）
• 页脚内容：doc.sections[0].footer.paragraphs
• 文本框内容：需要通过doc.inline_shapes或doc.shapes来访问，不过这属于进阶场景了。

内容的提问来源于stack exchange，提问作者E. Epstein