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命令轻松完成安装：

python 复制代码

pip install python-docx

3. 基本使用

3.1 创建新文档

使用python-docx创建新文档非常简单：

python 复制代码

from docx import Document

doc = Document()
doc.save("新文档.docx")

3.2 添加段落和文本

可以轻松向文档中添加段落和文本：

python 复制代码

paragraph = doc.add_paragraph()
run = paragraph.add_run("这是一段文本内容")

4. 图片处理与Cm模块

python-docx库中的Cm模块是图片尺寸控制的关键工具。它允许开发者以厘米为单位指定图片尺寸，使文档更加专业和统一。

4.1 Cm模块详解

Cm模块位于docx.shared包中，用于设定图片尺寸大小。一个重要的特性是：只需给定宽度或高度，另一个维度会自动计算以保持图片原始比例。

python 复制代码

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创建包含多张图片的文档：

python 复制代码

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 文本格式化

python 复制代码

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 表格操作

python 复制代码

table = doc.add_table(rows=3, cols=3)
cell = table.cell(0, 0)
cell.text = "表格示例"

6.3 页面设置

python 复制代码

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都能提供强大的支持。