日常需要经常处理Word文档，发现了一个新的Python包：Python-docx，处理docx十分方便。

而且这个包和pandas包结合使用，可以在word插入excel表格，节省了很多复制、粘贴、调整表格样式的时间，真的很方便！

但是要注意：Python-docx只能处理docx、docx、docx文件！

下面给大家介绍一下如何使用Python-docx吧，抛砖引玉~

0. 学习思路

一、 基础！安装Python-docx，并对照”官方帮助说明“了解包的对象和基本函数；这里建议在python交互模式下进行，可以直观的看到返回值和报错。

二、 出题！自己定义一个问题并解决，来加深对包的理解。题目：”创建一个docx文件，要求输入2个表格，并且这个表格有填充的数字，表格前有相应标题。“

三、 进阶！试试包的更多函数，看会触发什么效果。结合pandas，学习表格和字体、字号、颜色的处理

一、 基础

1.1 使用conda安装python-docx：

conda install -c conda-forge python-docx

没有了解过conda的同学，可以看看 Anaconda国内镜像停止后，怎么办？(已恢复)，文中有简单介绍。

1.2 简要了解Python-docx：

1 打开/读取文档

第一步当然是创建文档并打开啦~

from docx import Document

import os

path = "a.docx"

os.system("touch %s" %path) # 调用shell命令创建a.docx文件

documentNew = Document() # 不指定路径是创建文件

documnet = Document(path) # 指定路径是读取文件

w(ﾟДﾟ)w 发现报错 PackageNotFoundError ：

docx.opc.exceptions.PackageNotFoundError: Package not found ...

原来是因为a.docx中没有任何内容。打开a.docx之后输入几个字符，再重试以上代码，就不会报错了。

2 插入标题

使用 add_heading() 或add_paragraph()添加标题：

document.add_heading('Document Title', 0)

# 方法1

document.add_heading('Heading 1', level=1) # 用level设置，level为0-5，对应不同级别的标题

# 方法2

document.add_paragraph('Heading 1', style="Heading 1") # 用style来设置不同级别的标题

3. 插入段落

段落是word文档中最基本的对象之一。插入段落主要使用的函数是：add_paragraph() #添加段落

add_run() #追加文字

#插入段落， 同时设置粗体和斜体~

p = document.add_paragraph('A plain paragraph having some ')

p.add_run('bold').bold = True #粗体

p.add_run(' and some ')

p.add_run('italic.').italic = True #斜体

段落还可以使用style设置风格。

# 圆点列表

document.add_paragraph(

'first item in unordered list', style='List Bullet'

)

# 序号列表

document.add_paragraph(

'first item in ordered list', style='List Number'

)

# 引用

document.add_paragraph('Intense quote', style='Intense Quote')

4 插入图片

from docx.shared import Inches

document.add_picture('image-filename.png', width=Inches(1.0))

5 分页符

document.add_page_break()

6 插入表格

主要使用的函数：add_table() # 新建表格

add_row() # 添加行

add_col() # 添加列

table.cell(i, j).text() # 往表格中添加内容

table.rows() # 行数

table.cols() # 列数

records = (

(3, '101', 'Spam'),

(7, '422', 'Eggs'),

(4, '631', 'Spam, spam, eggs, and spam')

)

# 新建1行3列的表

table = document.add_table(rows=1, cols=3) # row行, col列

# 使用table 的rows()和columns()得到这个表格的行数和列数

print(len(table.rows))

print(len(table.columns))

# 添加标题行

hdr_cells = table.rows[0].cells # 注意 table.rows(0)表示第1行

hdr_cells[0].text = 'Qty'

hdr_cells[1].text = 'Id'

hdr_cells[2].text = 'Desc'

# 将records中的数据添加到新建的table中

for qty, id, desc in records:

row_cells = table.add_row().cells

row_cells[0].text = str(qty)

row_cells[1].text = id

row_cells[2].text = desc

如果熟悉pandas，那你肯定知道创建的dataframe默认会自带标题行。但是python-docx不同，需要自行添加标题行。这里要注意一下，不过别紧张不需要死记硬背，出现问题多调试就行~

7 保存文件

document.save(path) # 指定路径

二、 做题！

至此，官方文档的示例学的差不多了，基本上就是对标题、段落、表格和图片的处理。

下面来做一个简单的题目：创建一个docx文件，要求输入2个三行七列的三线表。

表格1：标题栏为数字1到7。表格前有相应标题“1. 表格1”，标题的字体为等线，且为斜体。

表格2：标题栏为大写字母A到G。表格前有相应标题“2. 表格2”, 标题的字号为12，且为粗体。

希望你先自己写一下，有问题多搜索。然后再来看看我的答案，对比下思路的不同。这样学的更快，有问题也可以互相交流学习~

实现代码：

#!/bin/usr/env python

from docx import Document

from docx.shared import Pt # 设置字号

document = Document()

# 表格1

# 标题1，字体为等线，且为斜体

title1 = document.add_heading(u'1.表格1', level=1)

title1.style.font.name = u'等线' # 设置中文字体前面要有u

title1.italic = True

table1 = document.add_table(rows=3,cols=7) # 3行7列

# 设置表格标题栏

for i in range(7):

table1.cell(0,i).text = str(i+1)

table1.style="Light Shading" # 风格为三线表

# 表格2

# 标题2，字号为12，且为粗体

title2 = document.add_paragraph(u'2.表格2',style="heading 1")

title2.style.font.size = Pt(12)

title2.bold = True

table2 = document.add_table(rows=3,cols=7) # 3行7列

headLine = ["A","B","C","D","E","F","G"]

# 设置表格标题栏

for i in range(7):

table2.cell(0,i).text = headLine[i]

table2.style="Light Shading" # 风格为三线表

# 储存

document.save("test.docx")

最终结果↓ ：

三、进阶

3.1 表格样式模板：

其中常用的有Light Shading(三线表)↓ ：

Table Grid(网格型)↓ ：

Light Grid(浅色网格)↓ ：

Medium List 1(中等深浅列表1) ↓：

Medium List 2(中等深浅列表2) ↓ ：

可以点击查看 python---word表格样式设置. 蜗v牛. CSDN 查看更多样式示例。但是现在的Python-docx包代码有些更新，样式和该链接中的图例部分有出入。使用时需要自行调试~

3.2 自定义表格样式

先试试下面的代码~

from docx import Document # 输出docx

from docx.shared import Pt # 设置字号

from docx.shared import Cm # 设置宽度，单位是cm

from docx.shared import RGBColor # 设置字体颜色

document = Document()

table = document.add_table(6,2, style="Normal Table")

colHeadLine = ["A","B","C","D","E","F"]

for i in range(6):

# 给单元格赋值的同时修改样式，不影响整个表格

cell = table.cell(i,0)

cell.width = Cm(2) # 设置单元格宽度为2cm

run = cell.paragraphs[0].add_run(colHeadLine[i])

run.font.color.rgb = RGBColor(0,100,0)

run.font.name = u'等线'

run.italic = True

table.columns[0].width=Cm(3)

# 修改整个表格的字体样式

table.style.font.size = Pt(10)

# 保存

document.save("test.docx")

3.2.1 表格自动适应窗口大小：

table.autofit = True

3.2.2 自定义表格宽度或高度：

a. 方法1：

table.cell(row,col).width = Cm(4) #

table.cell(row,col).height = Cm(4)

b. 方法2：

特别需要注意的是，column和row后面是有s的！

官方文档中有无s标注错误，害得我还以为不能这样操作，捂脸.jpg。

table.columns[0].width=Cm(2) # 不起效，不知道为什么

table.rows[0].height=Cm(2) # 起效

3.2.3 对齐

a. 表格对齐：

table.alignment = WD_TABLE_ALIGNMENT.CENTER #居中

table.alignment = WD_TABLE_ALIGNMENT.LEFT #靠左

table.alignment = WD_TABLE_ALIGNMENT.RIGHT #靠右

b. 文字对齐：

# 水平方向

table.cell(row,col).paragraphs[0].paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER

table.cell(row,col).paragraphs[0].paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT

table.cell(row,col).paragraphs[0].paragraph_format.alignment = WD_ALIGN_PARAGRAPH.RIGHT

# 垂直方向

table.cell(row,col).vertical_alignment = WD_ALIGN_VERTICAL.CENTER

table.cell(row,col).vertical_alignment = WD_ALIGN_VERTICAL.TOP

table.cell(row,col).vertical_alignment = WD_ALIGN_VERTICAL.BOTTOM

3.3 add_run() 设置字体、字号和颜色

from docx import Document

from docx.shared import Pt # 设置字号

from docx.shared import RGBColor # 设置字体颜色

document = Document()

p = document.add_paragraph('A plain paragraph')

run = p.add_run(' is plain') # 注意is之前的空格

run.font.name = u'等线' #设置字体

run.font.size = Pt(10.5) # 设置字号

run.font.color.rgb = RGBColor(250,0,0) # 设置字体颜色

# 保存

document.save("test.docx")3.3 结果

3.4 结合pandas的iloc函数，将dataframe写入word

import pandas as pd

from docx import Document # 输出docx

from docx.shared import Pt # 设置字号

document = Document()

df = pd.read_csv(a.csv, sep="\t")

rowNum = df.shape[0] + 1 # 行数，加标题栏

colNum = df.shape[1] # 列数

table = document.add_table(rows=rowNum, cols=colNum, style = "Light Grid")

table.cell(0,0).text = "a"

table.cell(0,1).text = "b"

table.cell(0,2).text = "c"

table.cell(0,3).text = "d"

for i in range(1, rowNum):

for j in range(colNum):

cell = table.cell(i,j)

cell.text = str(df.iloc[i-1,j])

table.autofit = True

table.style.font.name = u'等线'

table.style.font.size = Pt(12)

document.save(outPutDocx)

一个示例 ↓ ：

四、总结如何创建和读取文档

插入标题、段落、图片、分页符和表格

进阶学习，表格和段落的字体、字号、颜色的处理

后续如果发现更多有趣的用法，也会更新本文~

觉得有用别忘记点赞呀~

感谢O(∩_∩)O~

以上！

：梨酱：[论文写作 1] 如何用word批量制作三线表？​zhuanlan.zhihu.com梨酱：[Linux 1] Shell“ 多线程”，提高工作效率​zhuanlan.zhihu.com梨酱：[生信资料 3] 生物信息学常见数据格式，汇总！​zhuanlan.zhihu.com

参考：