Python自动化操作Word文档技巧分享

引言 / 什么是Python自动化操作Word文档

在日常办公中，Word文档的创建、编辑和格式化是高频操作，但重复性劳动往往消耗大量时间。例如，每月生成财务报表、批量修改合同条款或统一调整文档格式时，手动操作不仅效率低下，还容易出错。Python自动化脚本通过代码控制Word文档，能够快速完成这些任务，将原本需要数小时的工作缩短至几分钟。

本文将介绍如何使用Python的python-docx库实现Word文档的自动化操作。该库支持创建新文档、修改现有内容、设置段落样式、插入表格和图片等核心功能，且兼容.docx格式（Office 2007及以上版本）。通过掌握这些技巧，你可以轻松编写脚本处理合同生成、报告排版等场景，显著提升文档编辑效率。

准备工作

1. 安装Python环境：确保已安装Python 3.6+版本（推荐使用最新稳定版）。
2. 安装依赖库：通过pip安装python-docx库：

   pip install python-docx
   

3. 准备测试文档：建议准备一个简单的.docx文件用于后续修改操作测试。

基础操作 / 核心用法

步骤一：创建新文档并添加内容

使用Document()类初始化一个空白文档，通过add_paragraph()方法添加段落文本：

from docx import Document

# 创建新文档
doc = Document()

# 添加标题和正文
doc.add_heading('自动化生成的报告', level=1)
doc.add_paragraph('这是通过Python脚本生成的段落内容。')
doc.add_paragraph('支持多段落添加和格式设置。')

# 保存文档
doc.save('demo_report.docx')

关键点：

• add_heading()的level参数控制标题层级（1为一级标题）。
• 每次调用add_paragraph()会新增一个段落。

步骤二：修改现有文档内容

通过Document('文件名.docx')加载已有文档，使用paragraphs属性遍历段落并修改：

from docx import Document

# 加载现有文档
doc = Document('existing_file.docx')

# 修改第一个段落文本
if len(doc.paragraphs) > 0:
    doc.paragraphs[0].text = "这是修改后的第一段内容。"

# 保存修改后的文档
doc.save('modified_file.docx')

提示：直接修改paragraphs[i].text会覆盖原有内容。如需保留部分文本，可先读取再拼接。

步骤三：设置段落格式

通过paragraph.style属性设置样式，或使用add_run()实现部分文本格式化：

from docx import Document
from docx.shared import Pt, RGBColor

doc = Document()
p = doc.add_paragraph()

# 添加带格式的文本片段
run1 = p.add_run('红色加粗文本：')
run1.bold = True
run1.font.color.rgb = RGBColor(255, 0, 0)

run2 = p.add_run('普通文本。')
run2.font.size = Pt(12)

doc.save('formatted_text.docx')

常用格式属性：

进阶技巧

技巧一：批量插入表格

使用add_table()方法创建表格，并通过cell.text填充内容：

from docx import Document

doc = Document()

# 创建3行4列的表格
table = doc.add_table(rows=3, cols=4)

# 填充表头
header_cells = table.rows[0].cells
header_cells[0].text = "姓名"
header_cells[1].text = "年龄"
header_cells[2].text = "部门"
header_cells[3].text = "入职日期"

# 填充数据行
data_rows = [
    ["张三", "28", "技术部", "2020-01-15"],
    ["李四", "32", "市场部", "2018-05-20"]
]

for row_idx, row_data in enumerate(data_rows, start=1):
    for col_idx, cell_data in enumerate(row_data):
        table.cell(row_idx, col_idx).text = cell_data

doc.save('table_demo.docx')

技巧二：插入图片并调整大小

通过add_picture()插入图片，使用width和height参数控制尺寸：

from docx import Document
from docx.shared import Mm

doc = Document()

# 插入图片（单位：毫米）
doc.add_picture('logo.png', width=Mm(30), height=Mm(15))

# 添加图片说明
doc.add_paragraph('公司LOGO示例')

doc.save('image_demo.docx')

案例：自动化生成合同文档

以下脚本演示如何根据模板生成标准化合同：

from docx import Document
from datetime import datetime

def generate_contract(client_name, amount, due_date):
    # 加载模板
    doc = Document('contract_template.docx')
    
    # 替换占位符（假设模板中使用{{变量名}}标记）
    for paragraph in doc.paragraphs:
        if '{{client_name}}' in paragraph.text:
            paragraph.text = paragraph.text.replace('{{client_name}}', client_name)
        if '{{amount}}' in paragraph.text:
            paragraph.text = paragraph.text.replace('{{amount}}', f"￥{amount:,}")
        if '{{due_date}}' in paragraph.text:
            paragraph.text = paragraph.text.replace('{{due_date}}', due_date.strftime('%Y年%m月%d日'))
    
    # 添加动态表格（如服务清单）
    services = [
        ["网站开发", "5个工作日", "￥8,000"],
        ["系统维护", "12个月", "￥12,000"]
    ]
    
    table = doc.add_table(rows=1, cols=3)
    table.style = 'Light Shading Accent 1'
    
    # 设置表头
    hdr_cells = table.rows[0].cells
    hdr_cells[0].text = "服务项目"
    hdr_cells[1].text = "周期"
    hdr_cells[2].text = "费用"
    
    # 填充数据
    for item in services:
        row_cells = table.add_row().cells
        for i, value in enumerate(item):
            row_cells[i].text = value
    
    # 保存合同
    filename = f"合同_{client_name}_{datetime.now().strftime('%Y%m%d')}.docx"
    doc.save(filename)
    return filename

# 使用示例
generate_contract("ABC公司", 20000, datetime(2026, 10, 1))

常见问题

Q：如何处理加密的Word文档？

A：python-docx不支持直接操作受密码保护的文档。需先通过其他工具解密，或使用win32com（仅Windows）调用Office原生接口。

Q：脚本生成的文档打开报错怎么办？

A：常见原因包括：

1. 使用了旧版.doc格式（需保存为.docx）
2. 代码中存在非法字符（如未转义的\）
3. 文档未正确关闭（确保调用save()后程序退出）

Q：如何批量处理多个文档？

A：结合os.listdir()遍历文件夹，或使用glob模块匹配文件模式：

import glob
from docx import Document

for filepath in glob.glob('*.docx'):
    doc = Document(filepath)
    # 处理逻辑...
    doc.save(f"processed_{filepath}")

小结

通过本文的介绍，你已掌握Python自动化操作Word文档的核心技巧：使用python-docx库创建、修改、格式化文档，插入表格和图片，以及通过模板生成标准化文件。这些方法尤其适用于需要批量处理文档的场景，如生成月度报告、合同模板填充等。

实践建议：

1. 从简单脚本开始，逐步增加复杂度
2. 为常用操作封装函数（如格式设置、表格生成）
3. 结合logging模块记录脚本执行过程
4. 定期备份重要文档以防意外覆盖

掌握这些技能后，你将能节省大量重复劳动时间，将精力集中在更有价值的工作上。立即尝试编写你的第一个Word自动化脚本吧！