1. 快速入门：从打开到读取 Word 文档
环境准备
在这部分内容中，我们从最基本的准备工作开始，确保你能够通过 Python 操作 Word 文档。正确安装所需的库与配置运行环境是关键，常用的组合包括 python-docx、Python 3.x 版本以及一个可用的 Word 文档。通过以下步骤可以快速上手：安装库、确认文件路径、准备示例文档。
接下来，我们关注一个简单的流程：如何用 Python 打开一个 Word 文档并读取其文本内容。这是后续批量处理的基础，只有掌握打开和读取，才能开展更高级的编辑与自动化任务。
示例：打开并读取内容
下面的代码演示如何使用 python-docx 打开一个 docx 文件并读取其中的段落文本。注意：python-docx 只支持 .docx，对于旧版 .doc 需要先转换为 .docx。
from docx import Document# 打开文档
doc = Document('sample.docx')# 读取所有段落文本
texts = [para.text for para in doc.paragraphs]# 打印合并文本，便于快速查看内容
print("\\n".join(texts))读取文本时，往往需要考虑段落的格式和段落中的 Run，这有助于后续精确地提取文本信息。
示例：读取表格中的内容
除了段落，Word 文档中的表格也是重要信息载体。通过遍历表格，我们可以提取单元格中的文本。表格数据往往需要在数据处理流程中单独处理，以避免错位或遗漏。
# 读取文档中的所有表格文本
for table in doc.tables:for row in table.rows:row_text = [cell.text for cell in row.cells]print(\" | \".join(row_text))示例：处理 Run 和文本样式
段落中的 Run 对象承载了实际的文本与样式信息。理解 Run 的属性有助于后续的文本替换与格式保留，如粗体、斜体等。
for para in doc.paragraphs:for run in para.runs:if run.bold:print(\"Bold text:\", run.text)2. 使用 python-docx 修改段落和样式
基本操作
在 Word 文档中修改文本和添加新文本，是自动化编辑的核心能力。通过 Run 对象可以实现精细化文本格式控制，而通过 Paragraph 的 style 属性可以实现统一的文档风格。
下面的示例展示如何添加新文本并设置粗体效果，同时将段落样式改为 Heading 1，使文档具有层级结构。
应用样式与格式
你可以通过如下方式创建一个新的文本片段并应用样式。样式的正确命名与模板相容性直接决定了最终文档的外观，请在使用前确认所选样式在目标文档模板中存在。
from docx import Documentdoc = Document('sample.docx')# 修改第一段文本并添加新文本
para = doc.paragraphs[0]
para.add_run(\" 新的段落文本\").bold = True# 将第一段应用 Heading 1 样式
para.style = 'Heading 1'# 保存修改后的文档
doc.save('sample_modified.docx')修改现有文本的技巧
在实际场景中，往往需要对现有文本进行替换和追加。通过遍历段落和 Run，可以实现条件替换、保留原有风格、并对关键字做标记，从而保留文档结构的同时完成内容更新。
from docx import Documentdoc = Document('report.docx')
target = '旧关键字'
replacement = '新关键字'for para in doc.paragraphs:if target in para.text:for run in para.runs:if target in run.text:run.text = run.text.replace(target, replacement)doc.save('report_updated.docx')3. 在表格和图片中嵌入数据
操作表格
表格是 Word 文档中不可忽视的结构化数据载体。通过 Python 可以自动创建表格、填充数据、合并单元格（需要额外的处理逻辑），以实现数据驱动的文档生成。
以下示例展示如何添加一个 3x3 的表格并填充数据，适用于报表、清单等场景。
from docx import Documentdoc = Document()
table = doc.add_table(rows=3, cols=3)for i in range(3):for j in range(3):table.cell(i, j).text = f\"R{i+1}C{j+1}\"doc.save('table_generated.docx')插入图片与图示
将图片嵌入 Word 文档是提升可读性的重要手段。使用 add_picture 可以将图片插入到文档末尾，必要时可以设置尺寸，以确保排版和页面布局的稳定性。
下面的代码演示如何在文档中插入图片并控制宽度。
from docx import Document
from docx.shared import Inchesdoc = Document('report.docx')
doc.add_picture('chart.png', width=Inches(5.0))
doc.save('report_with_image.docx')4. 批量处理：自动化批量替换和导出
批量文本替换
批量处理是实现高效工作的关键。本节展示如何在一个目录下批量打开 Word 文档，执行文本替换，并将结果输出到新的文件夹中。批量处理可以显著降低重复工作量，适用于模板化文档生成、统一口径修订等场景。
通过结合 glob 与 python-docx，可以实现跨文件的一致性替换与风格统一。
import os
from glob import glob
from docx import Documentsrc_dir = 'docs/'
dst_dir = 'docs_out/'
os.makedirs(dst_dir, exist_ok=True)for path in glob(src_dir + '*.docx'):doc = Document(path)for para in doc.paragraphs:if '需要替换的文本' in para.text:for run in para.runs:run.text = run.text.replace('需要替换的文本', '替换文本')base = os.path.basename(path)doc.save(os.path.join(dst_dir, base))导出为新文档与命名约定
在批量导出阶段，统一的命名规则有助于后续管理与检索。建议包含日期、版本、主题等信息，以便于团队协同与审计。
from datetime import datetime
import os
from docx import Documentdef save_with_metadata(doc, original_path, suffix='_v1'):date_str = datetime.now().strftime('%Y%m%d')base = os.path.splitext(os.path.basename(original_path))[0]new_name = f\"{base}_{date_str}{suffix}.docx\"doc.save(os.path.join('docs_out', new_name))doc = Document('template.docx')
# 假设进行了某些修改
save_with_metadata(doc, 'template.docx')5. 高级技巧：与 Word 脚本结合
模板与生成
在大型自动化任务中，模板的作用不可或缺。通过加载模板文档并在其基础上创建新文档，可以确保格式一致性、字体统一以及布局的稳定性，从而减少人工排版时间。
你可以用模板载入一个初始文档，再通过程序化的写入来替换占位符、填充数据并输出最终版本。
from docx import Documenttemplate_path = 'invoice_template.docx'
doc = Document(template_path)# 假设模板中包含占位符
for para in doc.paragraphs:if '{NAME}' in para.text:para.text = para.text.replace('{NAME}', '张三')if '{TOTAL}' in para.text:para.text = para.text.replace('{TOTAL}', '$123.45')doc.save('invoice_张三.docx')错误处理与日志
在自动化流水线中，错误处理与日志记录是保障稳定性的关键。你可以配合 Python 的 logging 模块，对关键步骤进行日志记录，同时对异常进行捕获，以便后续分析与回滚。
import logging
from docx import Documentlogging.basicConfig(filename='wordOps.log', level=logging.INFO,format='%(asctime)s - %(levelname)s - %(message)s')try:doc = Document('unknown.docx')
except Exception as e:logging.error(f\"打开文档失败: {e}\")
else:logging.info('文档打开成功，开始处理文本替换')# 继续处理
