告别手动排版！这个Python库让你轻松玩转Word自动化

2025-10-27

👉 项目官网：https://www.python-office.com/ 👈

👉 本开源项目的交流群 👈

大家好，我是程序员晚枫。

今天给大家介绍一个我在工作中经常用到的神器：python-docx。它能够自动生成和修改Word文档，彻底告别手动复制粘贴和排版的烦恼！

什么是python-docx？

python-docx是一个专门用于操作Word文档的Python库。简单来说，它让你能够用代码来写Word，实现文档处理的自动化。

核心能力：

📝 创建全新的Word文档
📖 读取现有文档内容
🎨 设置文档样式和格式
📊 添加表格、图片等元素

为什么要用python-docx？

想象一下这些场景：

每月都要从Excel中复制数据到Word制作报告
需要批量生成100份内容相似但数据不同的合同
要给几十个文档统一修改页眉页脚

这些重复性工作，用python-docx几行代码就能搞定，省时省力还不会出错！

实战开始：从安装到第一个程序

1. 安装

1	pip install python-docx

2. 创建你的第一个自动化文档

from docx import Document

def create_simple_doc():
    # 创建文档对象
    doc = Document()
    
    # 添加标题
    doc.add_heading('晚枫的Python自动化报告', level=0)
    
    # 添加段落
    p = doc.add_paragraph('这是用python-docx生成的第一个文档！')
    
    # 在段落后面追加内容
    p.add_run('这些文字是加粗的').bold = True
    p.add_run('，而这些是红色的。').font.color.rgb = RGBColor(255, 0, 0)
    
    # 保存文档
    doc.save('我的第一个自动化文档.docx')

create_simple_doc()

运行这段代码，你就得到了一个格式规范的Word文档！

真实工作场景应用

场景1：自动生成周报

def generate_weekly_report(projects, achievements, plans):
    doc = Document()
    
    doc.add_heading('工作周报', level=0)
    
    doc.add_heading('本周完成工作', level=1)
    for project in projects:
        doc.add_paragraph(project, style='List Bullet')
    
    doc.add_heading('成果与问题', level=1)
    doc.add_paragraph(achievements)
    
    doc.add_heading('下周计划', level=1)
    for plan in plans:
        doc.add_paragraph(plan, style='List Bullet')
    
    filename = f'周报_{datetime.now().strftime("%Y%m%d")}.docx'
    doc.save(filename)
    return filename

场景2：批量生成合同

def generate_contracts(client_list):
    for client in client_list:
        doc = Document('晚枫的合同模板.docx')
        
        # 替换占位符
        for paragraph in doc.paragraphs:
            if '{{客户姓名}}' in paragraph.text:
                paragraph.text = paragraph.text.replace('{{客户姓名}}', client['name'])
            if '{{金额}}' in paragraph.text:
                paragraph.text = paragraph.text.replace('{{金额}}', client['amount'])
        
        doc.save(f'合同_{client["name"]}.docx')