说说如何使用 python-docx 写入 word 文档_deniro的专栏文章_微信文章

python-docx 除了可以读取 word 文档之外，还支持写入操作。

1 基本模式

import docx

doc = docx.Document()
...
doc.save('xxx.docx')
复制代码

基本模式说明如下：

调用 docx.Document() 之后，就会返回一个新的、空白的 Document 对象。
然后调用具体逻辑，比如设置中文字体、新增段落等等。
最后，保存为具体 docx 文档。

2 设置中文字体

因为默认为英文字体，所以必须指定我们所需要的中文字体：

import docx
from docx.oxml.ns import qn

doc = docx.Document()
# 设置正文中文字体
microsoft_font = u'微软雅黑'  # u 表示后面的字符串以 Unicode 格式进行编码
area = qn('w:eastAsia')
doc.styles['Normal'].font.name = microsoft_font
doc.styles['Normal']._element.rPr.rFonts.set(area, microsoft_font)
...
doc.save('xxx.docx')
复制代码

3 新建标题

我们为文档，新建一个“黑体”字体的标题：

import docx
from docx.oxml.ns import qn

doc = docx.Document()
...
black_font = u'黑体'
run = doc.add_heading('', level=1).add_run('概要设计')
run.font.name = black_font
run._element.rPr.rFonts.set(area, black_font)
...
doc.save('xxx.docx')
复制代码

生成的 word ：

标题的等级级别，可以通过 add_heading 方法的 level 属性来设定。
因为标题一般为黑体，所以这里也做了相应的转换。

4 新建段落

通过 add_paragraph 方法，就可以新建段落：

import docx

doc = docx.Document()
...

# 新增新的段落
paraObj1 = doc.add_paragraph(
    '概要设计是一个设计师根据用户交互过程和用户需求来形成交互框架和视觉框架的过程，其结果往往以反映交互控件布置、界面元素分组以及界面整体板式的页面框架图的形式来呈现。这是一个在用户研究和设计之间架起桥梁，使用户研究和设计无缝结合，将对用户目标与需求转换成具体界面设计解决方案的重要阶段。')
run2 = paraObj1.add_run('概要设计的主要任务是把需求分析得到的系统扩展用例图转换为软件结构和数据结构。')
...
doc.save('xxx.docx')
复制代码

生成的 word ：

5 换行

Run 对象有一个 add_break() 方法，调用它，就会换行：

...
# 新增换行符
run2.add_break()
run2.add_break()
...
复制代码

生成的 word ：

6 新增图像

add_picture() 可以实现在文档尾部增加图片。第一个参数是图片的地址；width 与 height 分别是图片的宽度与高度，单位可以是英寸（docx.shared.Inches）或者厘米（docx.shared.Cm）。

...
# 新增图像
doc.add_picture('timg.jpg',width=docx.shared.Cm(10),height=docx.shared.Cm(7))
...
复制代码

生成的 word ：

7 完整示例代码

import docx
from docx.oxml.ns import qn

doc = docx.Document()
# 设置正文中文字体
microsoft_font = u'微软雅黑'  # u 表示后面的字符串以 Unicode 格式进行编码
area = qn('w:eastAsia')
doc.styles['Normal'].font.name = microsoft_font
doc.styles['Normal']._element.rPr.rFonts.set(area, microsoft_font)

# 设置标题样式
black_font = u'黑体'
run = doc.add_heading('', level=1).add_run('概要设计')
run.font.name = black_font
run._element.rPr.rFonts.set(area, black_font)

# 新增新的段落
paraObj1 = doc.add_paragraph(
    '概要设计是一个设计师根据用户交互过程和用户需求来形成交互框架和视觉框架的过程，其结果往往以反映交互控件布置、界面元素分组以及界面整体板式的页面框架图的形式来呈现。这是一个在用户研究和设计之间架起桥梁，使用户研究和设计无缝结合，将对用户目标与需求转换成具体界面设计解决方案的重要阶段。')
run2 = paraObj1.add_run('概要设计的主要任务是把需求分析得到的系统扩展用例图转换为软件结构和数据结构。')

# 新增换行符
run2.add_break()
run2.add_break()

# 新增图像
doc.add_picture('timg.jpg',width=docx.shared.Cm(10),height=docx.shared.Cm(7))

doc.save('write.docx')

复制代码

生成的 word ：