Python操作Word文档全攻略：python-docx实战教程

关键词：Python操作Word、python-docx教程、自动化文档处理、Python办公自动化
描述：本文详细讲解如何使用python-docx库创建、编辑Word文档，包含标题设置、段落排版、表格插入等实战技巧，助你轻松实现文档自动化处理。

一、为什么需要Python操作Word？

在日常办公中，我们经常遇到需要批量生成报告、合同或格式化文档的场景。传统手动操作不仅效率低下，还容易出错。作为一名长期使用Python的开发者，我发现python-docx库能完美解决这些问题——它允许我们通过代码精准控制文档的每个细节。

记得去年帮财务部门自动化年度报表时，原本需要3天的工作，用Python脚本20分钟就完成了。这正是Python文档处理的魔力所在。

二、环境准备与基础操作

1. 安装python-docx

bash pip install python-docx

2. 创建第一个Word文档

python
from docx import Document

doc = Document()
doc.addheading('Python生成的文档', level=1) doc.addparagraph('这是我的第一个自动化Word文档！')
doc.save('demo.docx')

关键点说明：
- Document() 相当于新建空白文档
- add_heading() 添加标题，level控制标题级别（1-9级）
- 所有修改必须通过save()保存才会生效

三、核心功能实战详解

1. 文本精细化控制

python paragraph = doc.add_paragraph() run = paragraph.add_run('重点内容需要加粗和变色') run.bold = True run.font.color.rgb = RGBColor(255, 0, 0) # 红色文字

排版技巧：
- 使用add_run()对同一段落不同部分设置样式
- 字体大小通过font.size控制（单位：磅）
- 通过paragraph.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER实现居中

2. 表格自动化生成

python
table = doc.add_table(rows=3, cols=2)
table.style = 'Light Shading Accent 1' # 应用内置样式

填充数据

for i, (name, score) in enumerate([('张三', 89), ('李四', 92)]):
row = table.rows[i]
row.cells[0].text = name
row.cells[1].text = str(score)

注意事项：
- 表格索引从0开始
- 使用table.rows和table.columns进行行列操作
- 内置样式可通过print(doc.styles)查看全部选项

3. 图片与页眉页脚

python

插入图片

doc.add_picture('chart.png', width=Inches(5))

设置页眉

section = doc.sections[0]
header = section.header
header.paragraphs[0].text = "机密文件 - 禁止外传"

四、高级应用场景

1. 模板替换（批量生成合同）

python
def generatecontract(templatepath, outputpath, replacements): doc = Document(templatepath)

for paragraph in doc.paragraphs:
    for key, value in replacements.items():
        if key in paragraph.text:
            paragraph.text = paragraph.text.replace(key, value)

doc.save(output_path)

2. 文档合并

python
def mergedocs(outputpath, *input_files):
merged = Document()

for file in input_files:
    sub_doc = Document(file)
    for element in sub_doc.element.body:
        merged.element.body.append(element)

merged.save(output_path)

五、避坑指南

1. 样式丢失问题：直接复制内容可能导致样式异常，建议通过add_run()重建格式
2. 中文乱码处理：确保文件保存时指定编码doc.save('报告.docx', encoding='utf-8')
3. 版本兼容性：python-docx要求Office 2007及以上版本.docx格式

六、结语

通过python-docx，我们可以将重复的文档工作转化为自动化流程。虽然初期需要投入时间学习，但一旦掌握这项技能，工作效率将获得质的飞跃。建议从简单文档开始，逐步尝试复杂排版，最终实现完全自动化的文档生产流水线。

作者实践心得：在实现自动化方案时，建议先手动完成一次目标文档的制作，记录所有操作步骤，再思考如何用代码实现每个步骤——这种"逆向工程"的学习方法往往事半功倍。