背景

最近在做客户端性能测试的提效工作，会把以后版本的性能数据与上个版本的性能数据进行比照，而后把比照论断以及数据，放到 docx 文档上，主动生成一个性能报告，就学习了相干 Python-docx 的相干操作，记录如下。

根本介绍

python-docx 是用于创立可批改 微软 Word 的一个 python 库，提供全套的 Word 操作，是最罕用的 Word 工具。能够对文档进行更改，蕴含段落、分页符、表格、图片、题目、款式等简直所有的 word 文档中能罕用的性能都蕴含了。只能解析 docx 文件，解析不了 doc 文件。python-docx将整个文章看做是一个 Document 对象，其根本构造如下：

• 每个 Document 蕴含许多个代表“段落”的 Paragraph 对象，寄存在 document.paragraphs 中
• 每个 Paragraph 都有许多个代表 ” 行内元素 ” 的 Run 对象，寄存在paragraph.runs

根本的一些应用

from docx import Document as Doc
from docx.document import Document
import os

doc: Document = Doc()

word_path = os.getcwd()
doc.save(os.path.join(word_path, 'demo.docx'))

下面代码，咱们引入 python-docx 最外围的对象 Document，它对应的就是一个 word 文件，能够通过这个对象来操作 word 里的所有内容。

• 题目

doc.add_heading(text="一级题目", level=1)
doc.add_heading(text="二级题目", level=2)

text 参数制订题目的文字，level 制订题目的级别，一级题目还是二级题目，如果 level 等于 0，题目就会当做文档的 title，level 反对 1 - 9 个级别。

• 段落

doc.add_paragraph("测试段落一")
paragraph = doc.add_paragraph()  
paragraph.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER
run = paragraph.add_run("测试段落二")
run.bold = True
run.font.name = u'宋体'

增加段落有两种形式，如上：应用 doc.add_paragraph("测试段落一") 间接增加，另一种通过 add_run 来增加，同时能够操作文字的各种属性，比方粗体、字体、色彩等等

本文重点操作表格

创立

table = doc.add_table(2, 3, style="Table Grid")

调用 add_table 办法，并传入行数和列数，即可实现一个表格的创立，如下图：

增加表头

[‘ 场景 ’, ‘ 版本 ’, ‘ 内存 ’, ‘CPU’, ‘ 卡顿数 ’, ‘GPU’]假如咱们的表头内容寄存再这样一个列表中

columns = ['场景', '版本', '内存', 'CPU', '卡顿数', 'GPU']
table = doc.add_table(1, len(columns), style="Table Grid")
for i in range(len(columns)):
    row = table.rows[0]
    row.cells[i].text = columns[i]

依据表头的长度来确定表格有多少列，目前咱们还不晓得有多少行，就只须要增加一行就能够。

table.rows 能够获取所有行，row.cells 能够行内所有的单元格，而后通过给 text 属性赋值就能够实现单元格内容的填充。成果如下：

表头的内容咱们个别都须要加个背景色，让整体排版更好看一下

columns = ['场景', '版本', '内存', 'CPU', '卡顿数', 'GPU']
table = doc.add_table(1, len(columns), style="Table Grid")
for i in range(len(columns)):
    row = table.rows[0]
    row.cells[i].text = columns[i]
    shading = parse_xml(r'<w:shd {} w:fill="{bgColor}"/>'.format(nsdecls('w'), bgColor='129563'))
    row.cells[i]._tc.get_or_add_tcPr().append(shading)

通过 xml 来定义一个背景色，而后再通过调用 get_or_add_tcPr，这样增加北京色就胜利了。

舒适提醒：

shading = parse_xml(r'<w:shd {} w:fill=”{bgColor}”/>’.format(nsdecls(‘w’), bgColor=’129563′))

这里是先解析出一个 shading，如果每个单元格都增加这一个 shading，那么只有最初一个单元格能有背景色。所以这里须要每增加一次，都要从新解析一次。

合并单元格

举个栗子，比方咱们增加了四行，想把每行的第一列进行合并，代码如下：

a = table.add_row()
b = table.add_row()
c = table.add_row()
d = table.add_row()
d.cells[0].merge(a.cells[0])

理论的成果如下图。这里用到了_Cell 单元格对象的 merge 办法，实现单元格的合并，这里的 0，就是第一个单元格的索引。

给单元格字体增加色彩

给单元格文字增加色彩，和操作段落文字的原理是一样的，都是用 run 操作。代码如下：

data = ['B 站 feed 滑动', '6.54.0', 330, 14.5, 212, 12.5]
for i in range(len(columns)):
    run = a.cells[i].paragraphs[0].add_run(str(data[i]))
    run.font.color.rgb = RGBColor(255, 69, 0) # 这是红色的 RGB

成果如下：

情谊提醒：

留神这里给单元格增加内容时，必须字符串的模式，不然会报错

设置页面纸张大小

python-docx 生成的文档默认是 A4 的，当你想改成 A3 或者其余大小的时候，能够看看这里

document.sections[0].page_height = Cm(42)  # 设置 A3 纸的高度
document.sections[0].page_width = Cm(29.7)  # 设置 A3 纸的宽

老铁，你要点我