Python 操作 Word 写入

日常办公中，无论你是程序员还是普通文职人员，操作 Word 一定在你的工作中占了非常大的比例。项目文档、需求分析文档、合同报价、方案等等，这一系列都需要在Word中进行完成。但如何更高效灵活的使用 Word 你知道么？本小节将介绍 Python 第三方库 python-docx 模块完成对 Word 的操作。

1. python-docx模块介绍

python-docx 是用于创建和更新 Microsoft Word（.docx）文件的 Python 库。

通过本小节的学习，我们最终要完成Word文档 "info.docx"的创建，文档内容（花式 pick 慕课网）如下图所示。

1.1 安装

python-docx 是 Python 的第三方库，使用前需要通过以下命令进行安装：

pip install python-docx

1.2 使用步骤

步骤1：导入 docx 模块

from docx import Document

步骤2：创建（读取）一个文档对象

document = Document()  # 新建文档对象
Document("info.docx") #读取现有的word 建立文档对象

步骤3：向文档中写入内容

根据 docx 提供的方法，完成 Word文档所需内容的写入。

步骤4：生成 Excel 文件

from docx import Document
document = Document()  # 新建文档对象
...省略部分代码
document.save('C:/info.docx')# 保存文档

通过 save() 方法进行保存，生成 Word 文件，save() 方法可以传入你想要保存到的文件路径。到这里就完成了新的 Word 文档创建和内容写入的操作。

2. python-docx 操作 Word 写入

接下来，针对 python-docx提供的常用写入方法进行讲解，这里根据写入内容的类型进行划分。

2.1 写入文本

写入文本内容常用方法见下表。

下面来具体看下每个方法的使用：

1. add_heading() 使用：

from docx import Document
document.add_heading('慕课网简介', level=1)
document.save('info.docx')

代码解释：add_heading() 方法写入标题段落，段落样式由 level 决定，level范围为0 至 9，默认为1。执行完成后，info.docx 文档效果如下图所示。

2. add_paragraph() 使用：

from docx import Document
document.add_heading('慕课网简介', level=1)
p1 = document.add_paragraph(
    '慕课网是垂直的互联网IT技能免费学习网站。以独家视频教程、在线编程工具、学习计划、问答社区为核心特色。在这里，你可以找到最好的互联网技术牛人，也可以通过免费的在线公开视频课程学习国内领先的互联网IT技术')
document.save('info.docx')

代码解释：add_paragraph() 方法写入段落，段落样式由 style 决定（本小节中仅写入段落，后续小节会对应用样式进行介绍），执行完成后，info.docx 文档效果如下图所示。

3. insert_paragraph_before() 使用：

from docx import Document
document.add_heading('慕课网简介', level=1)
p1 = document.add_paragraph(
    '慕课网是垂直的互联网IT技能免费学习网站。以独家视频教程、在线编程工具、学习计划、问答社区为核心特色。在这里，你可以找到最好的互联网技术牛人，也可以通过免费的在线公开视频课程学习国内领先的互联网IT技术')
p1.insert_paragraph_before('!!!慕课网是垂直的互联网IT技能免费学习网站')
document.save('info.docx')

代码解释：insert_paragraph_before() 方法为插入段落到现有段落之前，段落样式由 style 决定。执行完成后，info.docx 文档效果如下图所示。

2.2 写入图片

写入图片方法，见下表。

对应代码中访问，如下所示：

from docx import Document
from docx.shared import Pt
document.add_heading('慕课网简介', level=1)
...省略部分代码
document.add_picture('logo.jpg')
document.add_picture('logo.jpg', Pt(20), Pt(30))
document.save('info.docx')

代码解释：add_picture() 方法为插入指定图片，并根据宽度和高度缩放。如果未指定宽度或高度，则图片以其原始尺寸显示。代码中共插入了 2 张 logo 图片，第一张没有设置宽度和高度即按原始尺寸插入，第二张根据指定的宽度和高度按比例缩放，参数 Pt 为 points 磅，与字号对应可以参考下图。

执行完成后，info.docx 文档效果如下图所示。

2.3 写入表格

写入表格方法，见下表。

通过表格可以很好的展示列表形式的数据，下面使用 add_table() 方法创建一个关于最新课程的表格，包含课程名称、讲师和价格。代码如下所示：

...省略部分代码
# 插入表格（1行3列，表格应用样式Medium List 2）
table = document.add_table(rows=1, cols=3, style='Medium List 2')
# 获取到第一行中的单元格列表
header_cells = table.rows[0].cells
header_cells[0].text = '新上好课' 
header_cells[1].text = '讲师'
header_cells[2].text = '价格'
# 初始化课程数据
data = (
    ['Java实操避坑指南', "勤一", 298],
    ['Vue2.5->2.6->3.0 开发去哪儿网APP', "DELL", 266],
    ['Vue3.0（正式版） + TS 仿知乎专栏企业级项目', "张轩", 298],
)
# 循环课程数据
for item in data:
	# 使用add_row()方法创建新的一行
    rows_cells = table.add_row().cells
    rows_cells[0].text = item[0]
    rows_cells[1].text = item[1]
    rows_cells[2].text = str(item[2])
document.save('info.docx')

代码解释：add_table() 方法为插入指定行数、列数的表格，参数rows为指定行数, cols为指定列数, style为表格应用的样式。代码中初始表格为 1 行 3 列，在填充处理的位置，通过遍历调用 add_row() 方法添加新的一行，为其设置各单元格内容。执行完成后，info.docx文档效果如下图所示。

3.小结

本节课程我们主要学习了 python-docx 模块的使用。本节课程的重点如下：

• 了解 python-docx 模块作用及使用步骤；
• 掌握 python-docx 模块中写入文本、图片、表格的使用方法。