Python3使用python-docx库创建Word文档详解

半杯拿铁

发布时间：2026-10-14 | 6人浏览过

原创

本文详解如何利用Python3及python-docx库自动化生成Word文档。内容涵盖标题、段落、文本样式的添加，以及图片、表格的插入方法。重点解析段落间距、行距及字体格式的设置技巧，帮助开发者掌握文档自动化生成的核心代码与配置参数。

Python3生成Word文档概述

熟悉Word文档的基本操作已非难事，但尝试使用Python代码构建并写入文章内容或许更具挑战性。这一过程需要借助代码逐步搭建文档框架，虽然步骤略显繁琐，建议初学者可将内容拆解为多个部分逐步理解。下文将结合Python3处理Word文档的具体代码进行讲解，并分享若干文档格式设置技巧。

Word文档核心元素与处理方法

一个标准的Word文档主要由以下几类内容元素构成，针对每种元素python-docx库均提供了相应的处理方法：

标题：使用 add_heading() 方法
段落：使用 add_paragraph() 方法
文本：使用 add_run() 方法，该方法返回的对象支持进一步设置文本属性
图片：使用 add_picture() 方法
表格：使用 add_table()、add_row() 及列相关方法

文档创建与内容添加代码示例


import pathlib

from docx import Document
from docx.shared import Inches, Pt
from docx.oxml.ns import qn
 
path = list(pathlib.Path.cwd().parents)[1].joinpath('data/automate/003word')
out_path = path.joinpath('003word_create.docx')
img_path = path.joinpath('dance.jpg')
document = Document()
document.add_heading('Python1024_自动生成标题', 0)
document.add_heading('基本：文本', level=1)
p = document.add_paragraph('测试文本\n测试内容\n')
p.add_run('粗体部分内容\n').bold = True
p.add_run('斜体部分\n').italic = True
p.add_run('下划线部分\n').underline = True
p.add_run('字体设置\n').font.size = Pt(24)
# 测试第三方字体
x = p.add_run('三方字体测试\n')
x.font.name = 'Source Han Sans CN' # 思源字体
x.element.rPr.rFonts.set(qn('w:eastAsia'), 'Source Han Sans CN')
# 段落和引用
document.add_heading('标题一：段落', level=1)
document.add_paragraph('引用块', style='Intense Quote')
document.add_heading('标题1.1、无序列表', level=2)
opts = ['选项1','选项2', '选项3']
# 无需列表
for opt in opts:
  document.add_paragraph(opt, style='List Bullet')
document.add_heading('标题1.2、有序列表', level=2)
# 有序列表
  document.add_paragraph(opt, style='List Number')
document.add_heading('标题二：图片', level=1)
document.add_picture(str(img_path), width=Inches(5))
document.add_page_break()
document.add_heading('标题三：表格', level=1)
records = (
  (1, '电风扇', '无叶风扇'),
  (2, '吹风机', '离子风机'),
  (3, 'Macbook pro', 'Apple macbook pro 15寸')
)
# 表格
table = document.add_table(rows=1, cols=3)
# 表头
hdr_cells = table.rows[0].cells
hdr_cells[0].text = '数量'
hdr_cells[1].text = 'ID'
hdr_cells[2].text = '描述信息'
# 表格数据
for qty, cid, desc in records:
  row_cells = table.add_row().cells
  row_cells[0].text = str(qty)
  row_cells[1].text = cid
  row_cells[2].text = desc
# 保存文档
document.save(out_path)

段落样式与间距设置

设置段落样式，

如下：


document.add_paragraph('这是一个样式为 ListBullet 的段落', style='ListBullet')

或


paragraph = document.add_paragraph('这是一个样式为 ListBullet 的段落')
paragraph.style = 'List Bullet'

设置段落间距

分为段前和段后，设置值用 Pt 单位是磅，如下：

段落行距配置详解


paragraph_format.space_before = Pt(18)
paragraph_format.space_after = Pt(12)

设置段落行距

当行距为最小值和固定值时，设置值单位为磅，需要用 Pt ；当行距为多倍行距时，设置值为数值，如下：


from docx.shared import Length

#SINGLE     => 单倍行距（默认）

#ONE_POINT_FIVE => 1.5倍行距

#DOUBLE2    => 倍行距

#AT_LEAST    => 最小值

#EXACTLY    => 固定值

#MULTIPLE    => 多倍行距

paragraph.line_spacing_rule = WD_LINE_SPACING.EXACTLY #固定值

paragraph_format.line_spacing = Pt(18) # 固定值18磅

paragraph.line_spacing_rule = WD_LINE_SPACING.MULTIPLE #多倍行距

paragraph_format.line_spacing = 1.75 # 1.75倍行间距

本文关于Python3处理Word文档的实例分析到此结束，更多相关Python3处理Word文档的代码内容请搜索本站以前的文章或继续浏览下面的相关文章，希望大家以后多多支持本站！