用python操作docx

⽤python操作docx
docx 库
⽂章结构：
⼀、docx 基本⽤，创建 docx ⽂件并添加数据
⼆、深⼊理解⽂本格式（format），并设置所格式属性（attribute）
三、深⼊理解样式（styles），以及如何运⽤样式
四、常⽤样式（style）⽰例
⼀、docx基本⽤法，创建docx ⽂件并添加数据
官⽅⽂档：https:///en/latest/
docx 可以操作 doxc 格式⽂件
linux 安装 sudo pip install python_docx （不要安装错了，python_docx 是新版本，如果只是安装 docx 有些 API 会不匹配） windows 安装 pip install python_docx
基本⽤法：
1 #!/usr/bin/env python
2 #coding: utf-8
3
4 from docx import Document
5 from docx.shared import Inches
6
7 #创建 Document 对象，相当于打开⼀个 word ⽂档
8 document = Document()
9
10 #向⽂档中添加⼀个标题，标题级别设置为0级
11 document.add_heading('This is title', level=0)
12
13 #向⽂档中添加⼀个段落，并将段落引⽤赋给变量 p
14 #使⽤ add_run ⽅法追加字段，并设置格式
15 p = document.add_paragraph('This is paragraph')
16 p.add_run('bold').bold = True
17 p.add_run(' and some ')
18 p.add_run('italic.').italic = True
19
20 #添加标题和段落，采⽤不同的形式
21 document.add_heading('This is Heading, level 1', level=1)
22 document.add_paragraph('Intese quote',style="Intense Quote")
23 document.add_paragraph('first item in unordered list', style='List Bullet')
24 document.add_paragraph('first item in ordered list', style='List Number')
25
26 #添加图⽚，设置图⽚⼤⼩
27 document.add_picture(r"D:\picture\a.jpg", width=Inches(2.25))
28
29 #添加表格，填⼊表格内容
30 table = document.add_table(rows=2, cols=2)
31 table.cell(0,0).text = "cell_00"
32 table.cell(0,1).text = "cell_01"
33 table.cell(1,0).text = "cell_10"
34 table.cell(1,1).text = "cell_11"
35
36 #保存⽂本
37 document.save('demo.docx')
效果展⽰：
<-------------------- start -------------------->
<-------------------- end -------------------->
⼆、深⼊理解⽂本格式（format），并设置所格式属性（attribute）
根据官⽅⽂档所述，word 中主要有两种⽤⽂本格式等级：块等级（block-level）和内联等级（inline-level） word 中⼤部分内容都是由这两种等级的对象组成的
（其他的诸如眉页、引脚等，docx 库的作者还在开发中）
块等级（block-level）：
段落是 word ⽂件中的主要块对象（block-level object）
块等级项（block-level item）主要任务是将⽂本格式从左边界向右边界展⽰（flows）；\
对于段落⽽⾔，边界就是分段标识，或者是⽂本的列边界
列表（table）也是块对象（block-level object）
内联等级（inline-level）：　
内联对象（inline-level object）是块对象（block-level object）的组成部分
块对象的所有内容都包含在内联对象中，⼀个块对象由⼀个或多个内联对象组成
run 是常⽤的内联对象，例如：
p = document.add_paragraph('This is paragraph')
p.add_run('bold').bold = True
p.add_run(' and some ')
p.add_run('italic.').italic = True
这个例⼦中⼀个段落（块对象）包含三个 run（内联对象），每⼀个 run 都设置有不同属性
块等级，及其属性
块对象⼀般包括：段落（paragraph）、图⽚（inline picture）、表（table）、标题（heading）、\
有序列表（numbered lists）、⽆序列表（bullets lists）
块对象的属性指定了块对象所在的位置，例如缩进、段间距离
常⽤属性：
alignment，⽔平对齐
from docx.enum.text import WD_ALIGN_PARAGRAPH
paragraph = document.add_paragraph("hello")
paragraph_format = paragraph.paragraph_format
#设置段落⽔平右对齐
paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
#WD_ALIGN_PARAGRAPH 存储了多种对齐格式，例如：
#WD_ALIGN_PARAGRAPH.LEFT，左对齐；WD_ALIGN_PARAGRAPH.RIGHT，右对齐
#更多参见https:///en/latest/api/enum/WdAlignParagraph.html#wdparagraphalignment
indent，缩进
from docx.shared import Inches
from docx.shared import Pt
#设置段落从左开始缩进，使⽤Inches来衡量
paragraph_format.left_indent = Inches(0.5)
#设置段落从右开始缩进，使⽤Pt来衡量
paragraph_format.right_indent = Pt(20)
#设置段落第⼀⾏缩进，可以与上两个缩进叠加
paragraph_format.first_line_indent = Inches(0.5)
space，⾏间距
from docx.shared import Pt
#设置与上⼀段间隔 Pt（5）
paragraph.space_after = Pt(5)
#设置与下⼀段间隔 Pt（10）
paragraph.space_before = Pt(10)
其他熟悉如字间距、页码等属性，参见⽂档：https:///en/latest/user/text.html 内联等级，及其属性
内联对象⼀般包括：⽂字、句⼦、段落
内联对象的属性指定了字体，例如粗体（bold）、斜体（italic）、⼤⼩（size）等等
常⽤属性：
name and size
document = Document()
paragraph = document.add_paragraph()
run = paragraph.add_run("hellohellohello")
font = run.font
#设置字体样式
= 'Calibri'
#设置字体⼤⼩
font.size = Pt(55)
bold 、underline and underline
#设置为斜体
font.italic = True
#不设置下划线
font.underline = False
#设置粗体为继承上⼀个字体的格式
font.bold = None
#这⼀类属性，每个有三种状态
#True 为使⽤属性；False 为不使⽤属性；None 默认属性继承⾃上⼀个字体
#此外，underline 属性还可以设置值，例如
font.underline = WD_UNDERLINE.DOT_DASH
#更多选项参见/en/latest/api/enum/WdUnderline.html#wdunderline
color
#以RGB⽅式设置颜⾊
from docx.shared import RGBColor
font.color.rgb = RGBColor(0x42, 0x24, 0xE9)
#使⽤内建主题设置颜⾊
#详细说明参见https:///en/latest/api/enum/MsoThemeColorIndex.html#msothemecolorindex
from docx.enum.dml import MSO_THEME_COLOR
font.color.theme_color = MSO_THEME_COLOR.ACCENT_1
三、深⼊理解样式（styles），以及如何运⽤样式
在 word 中，样式包括：段落样式(paragraph styles)、字符样式(character styles)、表样式(table styles)、列表样式(numbering styles) 样式类似于前端开发的 CSS，⼀处定义，处处使⽤
docx 库内的 styles 样式不包含 word 中全部的样式，有⼀些还在开发中，但是基本够⽤
Document 的属性 styles，包含了所有 docx 提供的可⽤样式
选取段落可⽤样式
#显⽰所有段落样式
from docx.enum.style import WD_STYLE_TYPE
styles = document.styles
paragraph_styles = [
s for s in styles if s.type == WD_STYLE_TYPE.PARAGRAPH
]
for style in paragraph_styles:
print()
#styles 为 Document 的属性，style 为段落的属性
#除了段落（paragraph），还有 run，表（table）有 style 属性
段落设置样式
document = Document()
#从styles中选取样式
paragraph = document.add_paragraph()
paragraph.style = document.styles['Heading 1']
#⽤样式名称直接赋值
paragraph2 = document.add_paragraph()
paragraph2.style = 'List Bullet'
#在创建段落时赋值
paragraph = document.add_paragraph(style='Body Text')
定义样式（style）中的字符格式（character format)
定义样式中的字符格式后，所有运⽤此样式的段落都有相应的字符格式
document = Document()
#从样式库中选取 'Normal' 样式，并提取 'Normal' 样式的字符属性
style = document.styles['Normal']
font = style.font
#设置样式中的字符属性，操作⽅法和上⾯改变内联对象属性⽅法⼀致
= "Microsoft YaHei UI"
font.size = Pt(50)
#将设置好字符属性的样式运⽤到段落中
p = document.add_paragraph("change font attribution", style = 'Normal')
定义样式（style）中的段落格式（paragraph format）
定义样式中的段落格式后，所有运⽤此样式的段落都有相应的段落格式
document = Document()
styles = document.styles
#选取 style，并设置 style 中的段落格式
style = styles['Heading 2']
para_format = style.paragraph_format
para_format.left_indent = Pt(20)
para_format.widow_control = True
#将设置好段落格式的 style 运⽤到段落中
p = document.add_paragraph('This is Heading, level 1', style = style)
简单总结
⽂章第⼆部分直接设置段落的格式（paragraph.format），字符的格式（run.font）
在这⼀部分，运⽤了 style 对象，统⼀设置了段落格式、字符格式
⼀旦 style 对象设置好了以后，可以多次反复利⽤
style 对象是从⽂件对象中提取（document.styles）的，docx 提供的 Style 类对象
四、常⽤样式（style）⽰例
段落样式
from docx.enum.style import WD_STYLE_TYPE
from docx import *
document = Document()
styles = document.styles
#⽣成所有段落样式
for s in styles:
if s.type == WD_STYLE_TYPE.PARAGRAPH:
document.add_paragraph('Paragraph style is : '+ , style = s)
document.save('para_style.docx')
字符样式
from docx.enum.style import WD_STYLE_TYPE
from docx import *
document = Document()
styles = document.styles
para = document.add_paragraph()
#⽣成所有字符样式
for s in styles:
if s.type == WD_STYLE_TYPE.CHARACTER:
run = para.add_run("Character style is: "++"\n")
run.style = s
document.save('character_style.docx')
表格样式
from docx.enum.style import WD_STYLE_TYPE
from docx import *
document = Document()
styles = document.styles
#⽣成所有表样式
for s in styles:
if s.type == WD_STYLE_TYPE.TABLE:
document.add_paragraph("Table style is : "+ )
document.add_table(3,3, style = s)
document.add_paragraph("\n")
document.save('demo2.docx')。