我要评论1. 为什么需要程序化操作 word
在很多业务场景中，我们需要批量生成格式统一的 word 报告、合同、标书或证书。手动复制粘贴不仅效率低下，还容易出错。使用 python 可以：
- 从数据库/excel 中读取数据，动态填入 word 模板
- 批量替换文档中的占位符
- 自动生成结构化的表格和图表
- 将大量文本信息快速整理成标准排版
- 实现办公流程自动化，节省 90% 以上的重复操作时间
python 操作 word 的主流库是 python-docx，它可以在不使用 microsoft 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 文档
我们从零开始生成一个文档，并向其中添加内容。
from docx import document
# 创建一个文档对象
doc = document()
# 添加标题 (默认样式为 'title')
doc.add_heading('python word 操作入门', level=1)
# 添加段落
doc.add_paragraph('这是第一个用 python 生成的 word 文档。')
# 保存文档
doc.save('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()创建一个新文档，传入路径则打开已有文件。paragraphs属性返回文档中所有段落对象，text属性获取文本。- 标题、列表项等本质上也是段落，只是应用了不同的样式。
4. 段落操作：增删改查与样式设置
段落是文档的基本单元。我们可以精细控制对齐方式、行间距、缩进等。
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.save('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.save('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，支持创建、合并单元格、设置样式等。
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.save('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.save('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.save('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.save('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.save('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.save('08_header_footer.docx')
print("页眉页脚文档已生成")
打开文档后，页脚会显示“第 x 页”。不同节可以拥有独立的页眉页脚。
9. 样式与主题：打造专业文档模板
除了内建样式（如 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.save('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 文档
思路：将一个文档的所有元素（段落、表格等）逐一复制到另一个文档末尾。
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').save('part1.docx') # 自己创建，可替换为真实文件
document('part2.docx').save('part2.docx')
merge_docs(doc, 'part1.docx')
merge_docs(doc, 'part2.docx')
doc.save('10_merged.docx')
print("合并完成：10_merged.docx")
注意：此方法会复制元素但不会自动处理样式/图片关系，复杂文档建议使用 python-docx 模板方式或 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.save('10_replaced.docx')
10.3 邮件合并（类似 mail merge）
典型场景：用同一个模板，根据数据源生成多份信函。
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.save(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")
批量转换：
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.saveas(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.savefig(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.save(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
这个案例串联了数据读取、图表生成、文档排版、页眉页脚、格式转换等核心技术。
13. 总结与扩展资源
通过本文，你已经从零开始掌握了 python 操作 word 的核心技能：
- 文档创建、段落与格式
- 表格、图片、超链接
- 页眉页脚、分节布局
- 样式与模板化
- 文档合并与邮件合并
- word 转 pdf 实际部署
常见问题与注意事项
- 字体缺失：服务器环境无中文字体时，生成的 docx 在其他电脑打开可能显示为方块。解决方案：安装所需字体，或通过
run.font.name设置通用字体（如宋体）。 - 图片路径：务必使用绝对路径或在运行目录下。
- 样式继承：当 run 的某个属性为
none时，表示继承最近的非 none 值，这可能造成格式混乱，建议显式设置。 - 大文档性能：通过
python-docx处理超长表格或大量图片时，速度会下降。可考虑直接操作 xml 或使用流式生成。
到此这篇关于从入门到精通详解python操作word的实战指南的文章就介绍到这了,更多相关python操作word内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
发表评论