Python-docx库详解：轻松实现Word文档自动化生成与图片尺寸控制
在现代办公自动化的浪潮中，文档处理是一项不可或缺的任务。Python作为一种强大的编程语言，提供了丰富的库来简化这些任务。其中，python-docx库是处理Word文档的有力工具，它允许开发者以编程方式创建、修改和分析Word文档。本文将详细介绍python-docx库的使用方法，特别是如何利用Cm模块控制图片尺寸。
1. python-docx库简介
python-docx是一个强大的Python库，允许开发者创建和修改Microsoft Word (.docx)文件。该库提供了丰富的API，使开发者能够控制文档的各个方面，包括段落、表格、图片插入和格式化等。
2. 环境准备
在开始之前，开发者需要安装python-docx库。可以使用pip命令轻松完成安装：
pip install python-docx
3. 基本使用
3.1 创建新文档
使用python-docx创建新文档非常简单：
from docx import Document
doc = Document()
doc.save("新文档.docx")
3.2 添加段落和文本
可以轻松向文档中添加段落和文本：
paragraph = doc.add_paragraph()
run = paragraph.add_run("这是一段文本内容")
4. 图片处理与Cm模块
python-docx库中的Cm模块是图片尺寸控制的关键工具。它允许开发者以厘米为单位指定图片尺寸，使文档更加专业和统一。
4.1 Cm模块详解
Cm模块位于docx.shared包中，用于设定图片尺寸大小。一个重要的特性是：只需给定宽度或高度，另一个维度会自动计算以保持图片原始比例。
from docx.shared import Cm
# 只指定宽度为16厘米，高度会自动计算
doc.add_picture("image.png", width=Cm(16))
# 只指定高度为10厘米，宽度会自动计算
doc.add_picture("image.png", height=Cm(10))
5. 实际案例分析
以下是一个实际的案例，展示如何使用python-docx创建包含多张图片的文档：
from docx import Document
from docx.shared import Cm
import os
dir_path_ = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
def _2word():
path = "202.docx"
pic_base_path = f"{dir_path_}\结果"
doc = Document()
# 添加第一个段落
p1 = doc.add_paragraph()
p1.add_run("命名格式：\n几次完成(一次/多次)")
# 遍历指定目录中的PNG文件并添加到文档
for file in os.listdir(pic_base_path):
if file.endswith("png") and "False" in file:
paragraph3 = doc.add_paragraph()
run = paragraph3.add_run(str(file[:-6] + ".png"))
# 使用Cm模块控制图片宽度为16厘米
doc.add_picture(f"{pic_base_path}/{file}", width=Cm(16))
# 添加流程图部分
p2 = doc.add_paragraph()
p2.add_run("\n流程图\n")
doc.add_picture(f"{dir_path_}\method5.png", width=Cm(16))
# 保存文档
doc.save(path)
if __name__ == "__main__":
_2word()
在这个例子中，代码实现了以下功能：
- 创建一个新的Word文档
- 添加标题段落说明命名格式
- 遍历指定目录下符合条件的PNG图片，并将它们添加到文档中
- 每张图片都设置为16厘米宽，高度自动计算
- 添加流程图部分标题
- 添加流程图并同样设置宽度为16厘米
- 保存文档到指定路径
6. 高级功能
除了基本的文档和图片处理，python-docx还提供了许多高级功能：
6.1 文本格式化
from docx.shared import Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
paragraph = doc.add_paragraph()
run = paragraph.add_run("格式化文本")
run.font.size = Pt(16) # 设置字体大小为16磅
run.font.bold = True # 设置为粗体
run.font.color.rgb = RGBColor(255, 0, 0) # 设置文字颜色为红色
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER # 居中对齐
6.2 表格操作
table = doc.add_table(rows=3, cols=3)
cell = table.cell(0, 0)
cell.text = "表格示例"
6.3 页面设置
from docx.shared import Mm
section = doc.sections[0]
section.page_height = Mm(297) # A4纸高度
section.page_width = Mm(210) # A4纸宽度
7. 注意事项
在使用python-docx库时，开发者应注意以下几点：
- 图片路径问题：确保图片路径正确，尤其是在跨平台应用时
- 文档保存：记得在所有操作完成后保存文档
- 单位换算：除了Cm，还可以使用Inches、Pt等单位
- 大文件处理：处理大量图片时，注意内存使用和性能优化
8. 总结
python-docx库是一个功能强大的工具，可以帮助开发者轻松创建和修改Word文档。特别是Cm模块的使用，使得控制图片尺寸变得简单而精确。通过本文介绍的方法，开发者可以轻松实现文档自动化生成，提高工作效率。
无论是生成报告、创建模板文档，还是批量处理Word文件，python-docx都能提供强大的支持。
