1、安装python-docx

我们使用python-docx来操作word文档，首先是安装：

pip install python-docx -i https://pypi.tuna.tsinghua.edu.cn/simple
1

然后放两个参考文档：

• 官方手册：https://python-docx.readthedocs.io/en/latest/index.html
• pypi官方地址：https://pypi.org/project/python-docx/

使用步骤

• 步骤1 导入docx模块
• 步骤2 创建或读取一个文档对象
• 步骤3 向文档写入内容
• 步骤4 生成docx文件

上代码：

# 步骤1
from docx import Document

# 步骤2
document = Document()  # 新建文档对象
# document = Document("test.docx")  # 读取现有word文档，建立文档对象

# 步骤3
...

# 步骤4
document.save("test.docx")  # 保存文档
1
2
3
4
5
6
7
8
9
10
11
12

2、添加标题

要求：添加标题，能设置标题的字体、大小、颜色等

上代码：

from docx import Document
from docx.shared import Pt, RGBColor
from docx.oxml.ns import qn

d = Document()
# 第一种设置标题的方式
d.add_heading("一级标题 hello world", level=0)

# 第二种设置标题的方式，此方式还可以设置文本的字体、颜色、大小等属性
run = d.add_heading("", level=1).add_run("二级标题")
# 设置西文字体
run.font.name = u'宋体'
# 设置中文字体
run._element.rPr.rFonts.set(qn('w:eastAsia'), u'宋体')
# 设置字体颜色
run.font.color.rgb = RGBColor(255, 55, 55)  # 红色
# 设置字体大小
run.font.size = Pt(30)
# 设置下划线
run.font.underline = True
# 设置删除线
run.font.strike = True
# 设置加粗
run.bold = True
# 设置斜体
run.italic = True
# 保存文档
d.save("test.docx")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

代码解释：

• 设置字体有两种方式，一种是全局配置，但是只对正文起作用：

  d = Document()
  d.styles['Normal'].font.name = u'宋体'
  d.styles['Normal']._element.rPr.rFonts.set(qn('w:eastAsia'), u'宋体')
  1
  2
  3

• 但是上面这种方式无法对add_heading()起作用，需要对标题设置字体，需要使用下面这种方式：

  run = d.add_heading("", level=3).add_run("三级标题")
  run.font.name = u'宋体'
  run._element.rPr.rFonts.set(qn('w:eastAsia'), u'宋体')
  1
  2
  3

• 使用run.font.size = Pt(30)设置字体大小，Pt表示磅，与字号对应关系如下：

  号数	磅值 (Pt)
  初号	42
  小初	36
  一号	26
  小一	24
  二号	22
  小二	18
  三号	16
  小三	15
  四号	14
  小四	12
  五号	10.5
  小五	9
  六号	7.5
  小六	6.5
  七号	5.5
  八号	5

3、添加段落

举例1：段落、分页、有序列表、无序列表、引用

上代码

from docx import Document
from docx.shared import Pt
from docx.oxml.ns import qn

d = Document()
# 设置全局属性
d.styles['Normal'].font.size = Pt(20)
d.styles['Normal'].font.name = u'Times New Roman'
d.styles['Normal'].element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')
# 新增一个段落
p1 = d.add_paragraph("这是第一个段落：")
# 继续添加文字
run = p1.add_run("段落中的文字")
run.font.size = Pt(10.5)
run.font.name = u'宋体'
run._element.rPr.rFonts.set(qn('w:eastAsia'), u'宋体')
# 有序列表
d.add_paragraph("有序列表1111", style="List Number")
d.add_paragraph("有序列表2222", style="List Number")
# 无序列表
d.add_paragraph("无序列表3333", style="List Bullet")
d.add_paragraph("无序列表4444", style="List Bullet")
# 引用
d.add_paragraph("引用5555", style="Intense Quote")
# 在段落p1前添加一个段落
p1.insert_paragraph_before("在段落p1前添加一个段落，我才是第一个段落")
# 增加分页
d.add_page_break()
# 添加一个段落
p2 = d.add_paragraph("我是新分页中的段落")
# 新分页中文字首行缩进两个字
p2.paragraph_format.first_line_indent = Pt(20) * 2
d.save("1111.docx")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

效果图：

代码解释：

• 字体效果：如果设置了全局的字体属性，那么所有正文都是那种字体，但是可以通过add_run()对象设置新的字体
• 首行缩进：通过设置paragraph_format.first_line_indent属性可以设置缩进大小为当前字体大小的2倍

举例2：对齐、间距、行距

上代码

from docx import Document
from docx.shared import Pt, Inches
from docx.oxml.ns import qn
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT

d = Document()
d.styles['Normal'].font.size = Pt(20)
d.styles['Normal'].font.name = u'Times New Roman'
d.styles['Normal'].element.rPr.rFonts.set(qn('w:eastAsia'), '宋体')
p = d.add_paragraph("《静夜思》"
                 "床前明月光，"
                 "疑似地上霜。"
                 "举头望明月，"
                 "低头思故乡。")
# 设置对齐格式
# 可选项有LEFT、CENTER、RIGHT、JUSTIFY、DISTRIBUTE等
p.paragraph_format.alignment = WD_PARAGRAPH_ALIGNMENT.LEFT
# 设置段落缩进
d.add_paragraph("右缩进，0.5英寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸寸").paragraph_format.right_indent = Inches(0.5)
d.add_paragraph("左缩进，20磅").paragraph_format.left_indent = Pt(20)
d.add_paragraph("首行缩进2个字符").paragraph_format.first_line_indent = Pt(20) * 2
# 设置段落间距 1.5倍行间距 1.5, 单倍行间距 1.0
d.add_paragraph("line_spacing设置为浮点数，表示行间距为行高的倍数").paragraph_format.line_spacing = 1.5
d.add_paragraph("line_spacing设置为具体的长度值，表示绝对距离").paragraph_format.line_spacing = Pt(50)
d.add_paragraph("space_before表示段前间距").paragraph_format.space_before = Pt(100)
d.add_paragraph("space_after表示段后间距").paragraph_format.space_after = Pt(30)
# 设置段落内部文字在遇到需分页情况时处理状态
p2 = d.add_paragraph("很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落很长的段落")
p2.paragraph_format.keep_together = True  # 段中不分页
p2.paragraph_format.keep_with_next = True  # 与下段同页
p2.paragraph_format.page_break_before = True  # 段前分页
p2.paragraph_format.widow_control = True  # 孤行控制
d.save("11111.docx")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

效果图：

代码解释：

• 段落对齐格式WD_PARAGRAPH_ALIGNMENT有多个可选项
  • LEFT 表示左对齐
  • CENTER 表示居中对齐
  • RIGHT 表示右对齐
  • JUSTIFY 表示两端对齐
  • DISTRIBUTE 表示散列对齐
• add_paragraph()对象可以设置paragraph_format的多种属性，包括：
  • 对齐方式 alignment
  • 段落缩进 right_indent left_indent first_line_indent
  • 段落间距 space_before space_after
  • 行间距 line_spacing
  • 分页设置 keep_together keep_with_next page_break_before widow_control
• 分页设置的属性说明：
  • keep_together 段中不分页
  • keep_with_next 与下段同页
  • page_break_before 在段落前增加分页符
  • widow_control 孤行控制，控制页面的孤行和孤立行

3、添加表格

举例1：获取单元格、获取行、获取列、新增行、新增列

上代码：

from docx import Document

d = Document()
t = d.add_table(rows=6, cols=4, style="Table Grid")
# 通过行、列来确定单元格，索引从0开始
cell = t.cell(0, 0)
cell.text = "第1行第1列"
# 获取第2行
rows = t.rows[1]
for cell in rows.cells:
    cell.text = f"第2行第..列"
# 获取第3列
cols = t.columns[2]
for cell in cols.cells:
    cell.text = f"第3列第..行"
# 增加行、增加列
for cell in t.add_row().cells:
    cell.text = "新增行"
t.add_column(cell.width)
d.save("ttt.docx")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

效果图：

代码解释：

• style可以为：可以查看此博文https://blog.csdn.net/qq_45464895/article/details/123173742
• 两种方式可以获取单元格
  • 方式一：通过t.cell(row, col)获取具体的单元格，索引从0开始
  • 方式二：通过rows = t.rows[0]或columns = t.colums[0]获取行或列，然后通过获取到的行rows.cells[0]或列columns.cells[0]获取具体的单元格
• 注意：设置单元格内容时，如果如果是int类型，需要转换成str：cell.text = str(i) i表示数字

举例2：首行设置背景色，合并单元格、表格文字居中

上代码：

from docx import Document
from docx.oxml.ns import nsdecls
from docx.oxml import parse_xml
from docx.enum.table import WD_CELL_VERTICAL_ALIGNMENT

d = Document()
t = d.add_table(rows=5, cols=6, style="Table Grid")
# 首行设置背景色
rows = t.rows[0]
for cell in rows.cells:
    shading_elm = parse_xml(r'<w:shd {} w:fill="D9D9D9"/>'.format(nsdecls('w')))
    cell._tc.get_or_add_tcPr().append(shading_elm)
# 合并单元格
a = t.cell(1, 0)
a.text = '111'
b = t.cell(2, 1)
b.text = '222'
b.merge(a)
# 往合并单元格中写入
e = t.cell(3, 3)
f = t.cell(4, 4)
e.merge(f)
cell = t.cell(3, 4)
cell.paragraphs[0].alignment = WD_PARAGRAPH_ALIGNMENT.CENTER  # 水平居中
cell.paragraphs[0].add_run("合并单元格写入")
cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER  # 垂直居中
d.save("tttt.docx")
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

效果图：

代码解释：

• 首行设置背景色：固定写法。fill="D9D9D9"可以在http://tool.chinaz.com/Tools/PageColor.aspx中找你需要的颜色进行替换
• 合并后的单元格写入，可以使用它所包含的所有单元格来定位，比如：合并(3, 3)和(4, 4)之间的单元格，那么可以通过(3, 3)(3, 4)(4, 3)(4, 4)定位这个合并后的单元格
• 单元格中设置居中方式：WD_CELL_VERTICAL_ALIGNMENT可以设置为如下几种：
  • TOP 文本与单元格的上边框对齐
  • CENTER 文本与单元格的中心对齐
  • BOTTOM 文本与单元格的底部边框对齐

  cell = t.cell(3, 4)
  cell.paragraphs[0].alignment = WD_PARAGRAPH_ALIGNMENT.CENTER  # 水平居中
  cell.paragraphs[0].add_run("合并单元格写入")
  cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER  # 垂直居中
  1
  2
  3
  4

4、添加图片

上代码：

from docx import Document
from docx.shared import Pt, Inches
d = Document()
d.add_picture("test.png", Inches(5))
d.add_picture("test.png", Pt(200))
d.save("ppp.docx")
1
2
3
4
5
6

代码解释：

5、添加页眉页脚

暂时没用到，需要可以参考下面的文章

参考文章：

• 这个很全：https://blog.csdn.net/qq_45464895/article/details/123173742
• https://blog.csdn.net/hihell/article/details/121966945
• https://www.cnblogs.com/1gaoyu/p/12656003.html
• https://www.5axxw.com/wiki/content/kbhv5m
• https://www.5axxw.com/wiki/topic/l8oj0b
• https://www.5axxw.com/wiki/content/qa5cih
• https://www.cnblogs.com/wangyueping/p/16018206.html
• https://blog.csdn.net/weixin_47383889/article/details/119847787
• https://blog.csdn.net/u012034742/article/details/106022019/
• https://blog.csdn.net/qq_27017791/article/details/108897521
• http://tool.chinaz.com/Tools/PageColor.aspx
• https://www.zhihu.com/question/511536143/answer/2313422603