在上一个系列中,我们对 Python 操作 Excel 进行了一次全面总结
从本篇文章开始,我们继续聊聊另外一种常见的文档格式:Word
2. 准备Python 操作 Word 最常见的依赖库是:python-docx
所以,在开始操作之前,我们需要在虚拟环境下安装这个依赖库
# 安装依赖 pip3 install python-docx 3. 写入实战我们需要了解一个 Word 文档的页面结构
它们分别是:
文档 - Document
章节 - Section
段落 - Paragraph
文字块 - Run
经常操作的数据类型包含:段落、标题、列表、图片、表格、样式
首先,使用 Document 创建一个文档对象,相当于创建一个空白文档
from docx import Document # 1、新建一个空白文档 doc = Document()然后,就可以往文档中写入数据了
使用文档对象的 add_heading(text,level) 方法可以写入标题
其中,第 1 个参数为标题内容,第 2 个参数代表标题的级别
比如:分别写入一级标题、二级标题、三级标题
# 2、新增内容 # 2.1 标题 # 分别写入一个一级标题,一个二级标题,一个三级标题 doc.add_heading('一级标题', 0) doc.add_heading('二级标题', 1) doc.add_heading('三级标题', 2)段落 Paragraph 包含 3 类,分别是:
普通段落
自定义样式的段落
引用段落
默认情况下,使用文档对象的 add_paragraph(text,style) 方法来添加一个段落
普通段落:假如第二个参数 style 没有传入,则代表添加一个普通的段落
引用段落:对于引用段落,只需要指定段落样式为 Intense Quote 即可
# 2.2.1 新增普通段落 doc.add_paragraph("我是一个普通段落。") # 2.2.3 新增一个引用段落 # 只需要指定样式为:Intense Quote doc.add_paragraph('--我是一个引用段落--',)自定义样式的段落:这里有 2 种实现方式
分别是:
创建一个空的段落对象,增加文字块 Run 的时候,同时指定字体样式
使用文档对象创建一个新的样式(或已经存在的样式),然后添加段落的时候,设置到第二个参数中
考虑到样式的样式的复用性,第 2 种方式可能更实用
对应的方法是:
document.styles.add_style(style_name,type)
以第 2 种实现方式为例,新增一个自定义样式的段落,设置段落的字体名称、大小、颜色、是否加粗、对齐方式等
PS:第 1 种实现方式,文末源码会提供
该方法第 2 个参数用来指定样式类型,包含 3 种
分别对应关系如下:
1:段落样式
2:字符样式
3:表格样式
def create_style(document, style_name, style_type, font_size=-1, font_color=None, font_name=None, align=None): """ 创建一个样式 :param align: :param document: :param style_name: 样式名称 :param style_type: 样式类型,1:段落样式, 2:字符样式, 3:表格样式 :param font_name: :param font_color: :param font_size: :return: """ if font_color is None: font_color = [] # 注意:必须要判断样式是否存在,否则重新添加会报错 style_names = [style.name for style in document.styles] if style_name in style_names: # print('样式已经存在,不需要重新添加!') return font_style = document.styles.add_style(style_name, style_type) # 字体大小 if font_size != -1: font_style.font.size = Pt(font_size) # 字体颜色 # 比如:[0xff,0x00,0x00] if font_color and len(font_color) == 3: font_style.font.color.rgb = RGBColor(font_color[0], font_color[1], font_color[2]) # 对齐方式 # 注意:段落、表格才有对齐方式 if style_type != 2 and align: font_style.paragraph_format.alignment = align # font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER # font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.LEFT # font_style.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.RIGHT # 中文字体名称 if font_name: font_style.font.name = font_name font_style._element.rPr.rFonts.set(qn('w:eastAsia'), font_name) return font_style需要注意的是,新添加的样式的时候,必须先判断样式名称是否存在,否则会报错
最后,添加段落的时候,将上面创建的样式传入到第 2 个参数中即可
使用 add_paragraph() 方法添加一个段落,返回值为一个段落对象
该对象同样可以使用 add_run(text,style) 方法,在段落后追加文字块 Run 并指定样式
# 1/段落样式 style_paragraph = create_style(document=doc, style_name="style2", style_type=1, font_size=30, font_color=[0xff, 0x00, 0x00]) # 2/字符样式 style_string = create_style(document=doc, style_name="style3", style_type=2, font_size=15, font_color=[0x00, 0xff, 0x00]) # 3/表格样式 # 对齐方式为:居中 style_table = create_style(document=doc, style_name="style4", style_type=3, font_size=25, font_color=[0x00, 0x00, 0xff], align=WD_PARAGRAPH_ALIGNMENT.CENTER) current_paragraph = doc.add_paragraph("我是一个自带样式的段落(方式二)!!!", style_paragraph) # 字符样式 current_paragraph.add_run("【段落2中的部分字符】", style_string)Word 文档中,有序列表和无序列表也比较常用
事实上,和添加段落类似,添加列表同样是使用文档对象的 add_paragraph() 方法,指定不同的样式 style 来添加
其中,
有序列表:List Number