Python操作Word实战指南：从入门到精通详解

1. 为什么需要程序化操作 Word

在很多实际业务场景中，经常需要批量生成格式统一的Word报告、合同、投标书、说明书或证书。单纯依靠手动复制粘贴，不仅效率偏低，而且很容易出现格式错乱、内容遗漏等问题。使用Python进行Word文档自动化处理，可以明显提升办公效率，优势也非常直接：

• 从数据库或Excel中提取数据，再动态写入Word模板
• 批量替换文档里的占位符，减少重复劳动
• 自动生成结构清晰的表格和图表内容
• 将大量文本快速整理为标准化排版文档
• 实现办公流程自动化，显著节省重复操作时间

当前Python操作Word文档最常用的库是python-docx。它的优势在于无需电脑预装Word软件，也能直接创建、读取和修改.docx文件，支持跨平台使用，整体性能和稳定性都比较不错。

2. 环境准备与库安装

开始前，先确认Python版本在3.7及以上，然后安装核心依赖库：

pip install python-docx
# 如果需要转PDF（推荐两种方式之一）
pip install docx2pdf    # 跨平台，但依赖系统Word或LibreOffice（Windows/macOS下常用）
pip install pywin32     # 仅Windows，调用MS Word应用程序

安装完成后，可以先做一个简单验证：

import docx
print(docx.__version__)

输出信息：

3. 入门：创建你的第一个 Word 文档

下面从最基础的示例开始，演示如何用Python从零创建一个Word文档，并写入简单内容。

from docx import Document

# 创建一个文档对象
doc = Document()

# 添加标题 (默认样式为 'Title')
doc.add_heading('Python Word 操作入门', level=1)

# 添加段落
doc.add_paragraph('这是第一个用 Python 生成的 Word 文档。')

# 保存文档
doc.sa ve('01_hello.docx')
print("文档已生成：01_hello.docx")

输出信息：

打开生成的文档后，你会看到一个大标题和一行普通正文。实际上，add_paragraph还可以传入第二个参数来指定段落样式，例如：

doc.add_paragraph('一段重要的提示', style='Intense Quote')

读取已有文档

doc = Document('01_hello.docx')
for para in doc.paragraphs:
    print(para.text)

输出信息：

Python Word 操作入门

这是第一个用 Python 生成的 Word 文档。

几个关键点：

• Document() 可用于创建新文档，传入文件路径时则表示打开现有Word文件。
• paragraphs 属性会返回文档中的全部段落对象，text 属性用于获取段落文本。
• 标题、编号列表、项目符号列表等，本质上也都是段落，只是应用了不同样式。

4. 段落操作：增删改查与样式设置

段落是Word文档的基础组成单元，可以精细控制对齐方式、行距、段前段后间距、首行缩进等排版细节。

4.1 段落对齐与间距

from docx import Document
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.shared import Pt, Inches

doc = Document()

para1 = doc.add_paragraph('居中对齐的段落')
para1.alignment = WD_ALIGN_PARAGRAPH.CENTER

para2 = doc.add_paragraph('右对齐，行间距 1.5 倍，段前 12 磅, 段后 6 磅。')
para2.alignment = WD_ALIGN_PARAGRAPH.RIGHT
para_format = para2.paragraph_format
para_format.line_spacing = 1.5
para_format.space_before = Pt(12)
para_format.space_after = Pt(6)

para3 = doc.add_paragraph('首行缩进 0.5 英寸的段落。' * 5)
para3.paragraph_format.first_line_indent = Inches(0.5)

doc.sa ve('02_paragraph_format.docx')
print("段落格式示例已生成：02_paragraph_format.docx")

输出信息：段落格式示例已生成：02_paragraph_format.docx

参数说明：

• WD_ALIGN_PARAGRAPH.LEFT/RIGHT/CENTER/JUSTIFY 用于控制段落的水平对齐方式。
• line_spacing 可以设置为浮点数表示倍数行距，也可以设置为具体的 Pt 值表示固定行距。
• space_before / space_after 控制段前与段后间距，first_line_indent 控制首行缩进。

4.2 添加换行与分页

para = doc.add_paragraph('第一行')
para.add_run('\n第二行（在同一个段落中换行）')
doc.add_page_break()  # 手动分页
doc.add_paragraph('新一页的内容')

5. Run 与字体：精细到文字的格式控制

一个段落通常由多个Run对象构成。所谓Run，就是一段相邻且格式相同的文本块。借助它，你可以在同一个段落中，为不同文字分别设置字体、字号、颜色、加粗、斜体、下划线等格式。

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

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

# 添加多个 Run
run1 = p.add_run('正常文字 ')
run2 = p.add_run('加粗红色 ')
run2.bold = True
run2.font.color.rgb = RGBColor(0xFF, 0x00, 0x00)
run2.font.size = Pt(14)

run3 = p.add_run('斜体下划线')
run3.italic = True
run3.underline = True
run3.font.name = 'Arial'

doc.sa ve('03_run_format.docx')
print("Run 格式示例已生成：03_run_format.docx")

输出信息：Run 格式示例已生成：03_run_format.docx

常用字体属性

from docx.shared import Pt
from docx.enum.text import WD_UNDERLINE

run = p.add_run('示例文本')
run.font.name = '黑体'
run.font.size = Pt(12)
run.font.bold = True
run.font.italic = True
run.font.underline = WD_UNDERLINE.DOT_DASH  # 点划线型下划线
run.font.color.rgb = RGBColor(0, 51, 153)
run.font.highlight_color = WD_COLOR_INDEX.YELLOW  # 需导入 WD_COLOR_INDEX

打印 Run 内容：

for para in doc.paragraphs:
    for run in para.runs:
        print(f"文本: {run.text} | 粗体: {run.bold} | 字体: {run.font.name}")

输出示例：

文本: 正常文字 | 粗体: None | 字体: None

文本: 加粗红色 | 粗体: True | 字体: 黑体

文本: 斜体下划线 | 粗体: None | 字体: Arial

需要注意的是，如果没有显式指定字体名称，run.font.name可能会返回None，这通常表示它继承了当前样式中的默认字体设置。

6. 表格实战：从创建到复杂排版

python-docx提供的表格API非常灵活，既能快速创建普通数据表，也支持合并单元格、设置表格样式、调整列宽等常见Word排版需求。

6.1 创建表格并填充数据

doc = Document()
doc.add_heading('员工信息表', level=2)

# 创建 4 行 3 列的表格
table = doc.add_table(rows=4, cols=3, style='Table Grid')
# 表头
headers = ['姓名', '部门', '工龄']
for i, header in enumerate(headers):
    cell = table.cell(0, i)
    cell.text = header
    # 表头加粗
    for paragraph in cell.paragraphs:
        for run in paragraph.runs:
            run.bold = True

# 数据
data = [
    ['张三', '研发部', '3'],
    ['李四', '市场部', '5'],
    ['王五', '财务部', '2']
]
for row_idx, row_data in enumerate(data, start=1):
    for col_idx, cell_text in enumerate(row_data):
        table.cell(row_idx, col_idx).text = cell_text

doc.sa ve('04_table.docx')
print("表格已生成：04_table.docx")

6.2 合并单元格与调整列宽

# 接上面代码，在已创建的表格上操作
# 合并第一行的前两列
a = table.cell(0, 0)
b = table.cell(0, 1)
a.merge(b)
a.text = '基本信息（合并单元格）'

# 设置列宽
from docx.shared import Cm
for cell in table.columns[0].cells:
    cell.width = Cm(4)
for cell in table.columns[1].cells:
    cell.width = Cm(4)
for cell in table.columns[2].cells:
    cell.width = Cm(2)

doc.sa ve('04_table_merged.docx')
print("合并单元格表格已生成")

6.3 逐行添加、删除行

# 动态添加行
row = table.add_row()
row.cells[0].text = '赵六'
row.cells[1].text = '行政部'
row.cells[2].text = '1'

# 删除最后一行（如果不需要）
# table._tbl.remove(table.rows[-1]._tr)   # 内部方法，谨慎使用

打印表格内容验证：

for row in table.rows:
    for cell in row.cells:
        print(cell.text, end='\t')
    print()

输出：

基本信息（合并单元格） 部门 工龄

张三 研发部 3

李四 市场部 5

王五 财务部 2

赵六 行政部 1

7. 图片与超链接：让文档图文并茂

7.1 插入图片并控制尺寸

from docx.shared import Inches
doc = Document()
doc.add_paragraph('下方是一张示例图片（请确保图片文件存在）：')

# 插入内联图片
doc.add_picture('python_logo.png', width=Inches(2), height=Inches(1.2))
# 只设宽度时高度自动等比例缩放
doc.add_picture('chart.png', width=Inches(4))

doc.sa ve('05_image.docx')
print("图片文档已生成")

add_picture 常用参数：

• width / height：用于指定图片尺寸，若只设置其中一个参数，另一个会按比例自动缩放。
• 尺寸单位可以使用Inches、Cm、Pt等。

7.2 添加超链接

python-docx本身没有直接提供独立的超链接函数，但可以通过添加超链接样式并附加关系的方式来实现。常见写法如下：

from docx.oxml.ns import qn
import docx

def add_hyperlink(paragraph, text, url):
    """为段落添加超链接"""
    part = paragraph.part
    r_id = part.relate_to(url, docx.opc.constants.RELATIONSHIP_TYPE.HYPERLINK, is_external=True)
    hyperlink = docx.oxml.shared.OxmlElement('w:hyperlink')
    hyperlink.set(qn('r:id'), r_id)
    new_run = docx.oxml.shared.OxmlElement('w:r')
    rPr = docx.oxml.shared.OxmlElement('w:rPr')
    c = docx.oxml.shared.OxmlElement('w:rStyle')
    c.set(qn('w:val'), 'Hyperlink')
    rPr.append(c)
    new_run.append(rPr)
    new_run.text = text
    hyperlink.append(new_run)
    paragraph._p.append(hyperlink)
    return hyperlink

doc = Document()
p = doc.add_paragraph('访问 ')
add_hyperlink(p, 'Python 官网', 'https://www.python.org')
doc.sa ve('06_hyperlink.docx')
print("超链接文档已生成")

执行完成后，段落中的“Python 官网”会显示为带蓝色下划线的可点击超链接。

8. 页面控制：分节符、页眉页脚与页码

一个Word文档可以包含多个节（Section），每个节都可以单独设置纸张大小、页面方向、页边距，以及页眉页脚等内容。

8.1 分节与页面设置

from docx import Document
from docx.shared import Inches, Cm
from docx.enum.section import WD_ORIENT

doc = Document()
# 第一节（默认存在）
section1 = doc.sections[0]
section1.page_width = Cm(21)
section1.page_height = Cm(29.7)
section1.orientation = WD_ORIENT.PORTRAIT  # 纵向
section1.left_margin = Cm(2.5)
section1.right_margin = Cm(2.5)

doc.add_paragraph('第一节的内容。')

# 添加新节，并设置为横向
doc.add_section()
section2 = doc.sections[1]
section2.orientation = WD_ORIENT.LANDSCAPE
section2.page_width = Cm(29.7)
section2.page_height = Cm(21)

doc.add_paragraph('第二节为横向页面，适合放置宽表格。')

doc.sa ve('07_sections.docx')
print("分节文档已生成")

8.2 页眉和页脚

doc = Document()
section = doc.sections[0]

# 页眉
header = section.header
header_para = header.paragraphs[0]
header_para.text = "公司内部文件 - 机密"
header_para.alignment = 2  # 居中 (CENTER)

# 页脚添加页码
footer = section.footer
footer_para = footer.paragraphs[0]
# 加入自动页码字段（PAGE 域）
footer_para.text = "第 "
run = footer_para.add_run()
fldChar1 = run._r.makeelement(docx.oxml.ns.qn('w:fldChar'), {"w:fldCharType": "begin"})
instrText = run._r.makeelement(docx.oxml.ns.qn('w:instrText'), {})
instrText.text = " PAGE "
fldChar2 = run._r.makeelement(docx.oxml.ns.qn('w:fldChar'), {"w:fldCharType": "end"})
run._r.append(fldChar1)
run._r.append(instrText)
run._r.append(fldChar2)
footer_para.add_run(" 页")

doc.add_paragraph('正文内容...')
doc.sa ve('08_header_footer.docx')
print("页眉页脚文档已生成")

文档打开后，页脚会显示“第 X 页”的自动页码。对于多节文档，还可以为不同节设置独立的页眉和页脚样式。

9. 样式与主题：打造专业文档模板

除了Word自带的内建样式（如Title、Heading 1、Normal等），你还可以通过自定义样式实现统一排版，这对于生成企业报告、合同模板、制度文档尤其有帮助。

9.1 使用内建样式

doc = Document()
doc.add_paragraph('标题自动应用 Heading 1', style='Heading 1')
doc.add_paragraph('此处为正常正文', style='Normal')
doc.add_paragraph('带编号的列表项 1', style='List Number')
doc.add_paragraph('带编号的列表项 2', style='List Number')
doc.sa ve('09_builtin_styles.docx')

9.2 自定义段落样式

from docx.enum.style import WD_STYLE_TYPE

style = doc.styles.add_style('MyCustomStyle', WD_STYLE_TYPE.PARAGRAPH)
style.font.name = '微软雅黑'
style.font.size = Pt(11)
style.font.color.rgb = RGBColor(0x33, 0x33, 0x33)
style.paragraph_format.space_after = Pt(8)
style.paragraph_format.line_spacing = 1.2

doc.add_paragraph('使用自定义样式的段落。', style='MyCustomStyle')

9.3 修改当前文档的默认样式

doc = Document()
style = doc.styles['Normal']
style.font.name = 'Times New Roman'
style.font.size = Pt(12)
style.paragraph_format.space_after = Pt(6)
doc.add_paragraph('所有 Normal 都会继承此设置。')

10. 高级操作：文档合并、替换与邮件合并

10.1 合并多个 Word 文档

实现思路并不复杂：将一个Word文档中的所有元素（例如段落、表格等）逐个复制到目标文档末尾即可。

from docx import Document

def merge_docs(target_doc, source_path):
    src = Document(source_path)
    for element in src.element.body:
        target_doc.element.body.append(element)

doc = Document()
doc.add_heading('合并文档示例', 0)
doc.add_paragraph('第一部分')

# 模拟两个独立文档
Document('part1.docx').sa ve('part1.docx')  # 自己创建，可替换为真实文件
Document('part2.docx').sa ve('part2.docx')

merge_docs(doc, 'part1.docx')
merge_docs(doc, 'part2.docx')
doc.sa ve('10_merged.docx')
print("合并完成：10_merged.docx")

需要注意，这种方法虽然可以复制文档元素，但不会自动完整处理样式依赖、图片关系和部分复杂对象。对于复杂Word模板，通常更建议采用模板填充方式或COM对象方案。

10.2 文本替换

doc = Document('template.docx')  # 包含占位符如 {{name}}
for para in doc.paragraphs:
    if '{{name}}' in para.text:
        para.text = para.text.replace('{{name}}', '张三')
# 注意：这种方式会清除原有 Run 级格式。更优雅的方法是遍历 Run 替换，保留格式：
for para in doc.paragraphs:
    for run in para.runs:
        if '{{' in run.text:
            run.text = run.text.replace('{{name}}', '张三')
doc.sa ve('10_replaced.docx')

10.3 邮件合并（类似 Mail Merge）

这是一个非常典型的自动化办公场景：基于同一个Word模板，根据不同数据源批量生成多份通知、信函或报告。

data = [
    {'name': '张三', 'amount': 5000},
    {'name': '李四', 'amount': 3000}
]
for i, record in enumerate(data):
    doc = Document('template_letter.docx')
    for para in doc.paragraphs:
        for run in para.runs:
            if '{{name}}' in run.text:
                run.text = run.text.replace('{{name}}', record['name'])
            if '{{amount}}' in run.text:
                run.text = run.text.replace('{{amount}}', str(record['amount']))
    doc.sa ve(f'letter_{i+1}.docx')
print("批量信函已生成")

11. 格式转换：Word 转 PDF 等

11.1 使用 docx2pdf (Windows/macOS)

from docx2pdf import convert

convert('report.docx', 'report.pdf')
print("转换完成：report.pdf")

如果需要批量将Word转PDF，也可以这样写：

convert('input_folder/', 'output_folder/')

11.2 使用 win32com (仅 Windows, 功能更强大)

import win32com.client

def docx_to_pdf(input_path, output_path):
    word = win32com.client.Dispatch("Word.Application")
    word.Visible = False
    doc = word.Documents.Open(input_path)
    doc.Sa veAs(output_path, FileFormat=17)  # 17 代表 PDF
    doc.Close()
    word.Quit()
    print(f"PDF 已生成: {output_path}")

docx_to_pdf('report.docx', 'report.pdf')

FileFormat 常量参考：

• 16：docx
• 17：PDF
• 其他格式可查 MSDN。

12. 实战案例：自动化生成月度报表

下面结合一个更贴近业务的案例：从Excel中读取销售数据，自动生成一份图文并茂的Word月报，并进一步导出为PDF文件。

数据准备 (sales_data.xlsx)

脚本实现

import pandas as pd
from docx import Document
from docx.shared import Inches, Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
import matplotlib.pyplot as plt
from docx2pdf import convert
import os

# 1. 读取数据
df = pd.read_excel('sales_data.xlsx')
print("读取数据预览：\n", df)

# 2. 生成图表
plt.figure()
plt.plot(df['月份'], df['销售额(万)'], marker='o', label='销售额')
plt.plot(df['月份'], df['利润(万)'], marker='s', label='利润')
plt.xlabel('月份')
plt.ylabel('金额（万元）')
plt.title('月度销售趋势')
plt.legend()
plt.tight_layout()
chart_file = 'sales_chart.png'
plt.sa vefig(chart_file)
plt.close()

# 3. 创建 Word 报告
doc = Document()

# 标题
title = doc.add_heading('月度销售报告', level=0)
title.alignment = WD_ALIGN_PARAGRAPH.CENTER

# 摘要
summary = doc.add_paragraph()
summary.add_run('报告摘要：').bold = True
summary.add_run(f'本期共分析 {len(df)} 个月数据，平均销售额 {df["销售额(万)"].mean():.2f} 万元。')

# 表格
doc.add_heading('详细数据', level=2)
table = doc.add_table(rows=len(df)+1, cols=3, style='Light Shading Accent 1')
# 表头
for i, col in enumerate(df.columns):
    table.cell(0, i).text = col
    for run in table.cell(0, i).paragraphs[0].runs:
        run.bold = True
# 数据行
for idx, row in df.iterrows():
    for j, val in enumerate(row):
        table.cell(idx+1, j).text = str(val)

# 插入图表
doc.add_heading('销售趋势图', level=2)
doc.add_picture(chart_file, width=Inches(5.5))

# 页脚
footer = doc.sections[0].footer
footer_para = footer.paragraphs[0]
footer_para.text = "自动生成报告 - 仅供内部使用"

report_path = 'monthly_report.docx'
doc.sa ve(report_path)
print(f"Word 报告已生成：{report_path}")

# 4. 转换成 PDF
pdf_path = 'monthly_report.pdf'
try:
    convert(report_path, pdf_path)
    print(f"PDF 报告已生成：{pdf_path}")
except Exception as e:
    print(f"PDF 转换失败（可能未安装 Word 或依赖缺失）: {e}")

执行输出：

读取数据预览：

月份 销售额(万) 利润(万)

0 1月 120 30

1 2月 150 40

2 3月 180 50

Word 报告已生成：monthly_report.docx

PDF 报告已生成：monthly_report.pdf

这个案例把Excel数据读取、图表生成、Word文档排版、页脚设置以及Word转PDF等核心流程串联了起来，非常适合作为Python自动生成Word报告的入门实战模板。

13. 总结与扩展资源

看到这里，你已经从零开始系统掌握了Python操作Word文档的核心能力：

• 文档创建、段落处理与文本格式设置
• 表格、图片、超链接插入
• 页眉页脚、分节与页面布局控制
• 样式定义与模板化排版
• 文档合并、批量替换与邮件合并
• Word 转 PDF 的实际应用与部署

最后再补充几个常见问题和注意事项

1. 字体缺失：如果服务器环境没有安装中文字体，生成的docx文件在其他电脑上打开时，可能会出现乱码或方块字。解决办法通常是安装所需字体，或者通过run.font.name指定更通用的字体，例如宋体。
2. 图片路径：建议优先使用绝对路径，或者确保图片文件位于当前运行目录中，否则插入图片时容易报错。
3. 样式继承：当Run的某些属性值为None时，表示该属性会继承最近的非None样式值，这有时会导致格式结果不符合预期，因此更建议显式设置关键格式。
4. 大文档性能：使用python-docx处理超长表格、大量图片或复杂模板时，速度可能明显下降。这种情况下可以考虑直接操作XML，或采用更适合大规模文档生成的方案。