Python处理Word文档：轻松将图片嵌入Word文件

引言

在日常办公和数据处理中，经常需要在Word文档中插入图片。Python作为强大的编程语言，通过python-docx库可以轻松实现这一功能。本文将带领您从零开始，学习如何将图片写入Word文档。

环境准备

首先，确保您的Python环境已安装python-docx库。如果未安装，可以通过pip安装：

pip install python-docx

此外，您需要准备一张图片文件（如example.jpg）作为测试。

基础用法

以下是一个简单的示例，展示如何打开一个Word文档并在其中插入一张图片：

from docx import Document
from docx.shared import Inches

# 创建一个Document对象
doc = Document()

# 添加一个段落
doc.add_paragraph('这是一张示例图片：')

# 插入图片，设置宽度为4英寸
doc.add_picture('example.jpg', width=Inches(4))

# 保存文档
doc.save('output.docx')

运行上述代码，您将得到一个名为output.docx的文档，其中包含图片。如需设置图片高度，可使用height参数。

高级操作

调整图片位置

通过add_picture方法插入的图片默认居左。若需改变对齐方式，可结合段落设置：

from docx.enum.text import WD_ALIGN_PARAGRAPH

paragraph = doc.paragraphs[-1]
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER

在表格中插入图片

有时需要在表格单元格中插入图片：

table = doc.add_table(rows=1, cols=1)
cell = table.cell(0, 0)
cell.paragraphs[0].add_run().add_picture('example.jpg', width=Inches(2))

批量处理

处理多张图片时，可以循环插入：

image_paths = ['img1.jpg', 'img2.png', 'img3.gif']
for path in image_paths:
    doc.add_picture(path, width=Inches(3))

常见问题

• 图片无法显示？确保图片路径正确，且格式受支持（如JPG、PNG）。python-docx会尝试转换图片，但某些格式可能失败。
• 图片尺寸过大？使用width和height参数控制尺寸，单位可为Inches或Cm。
• 内存不足？处理大量高分辨率图片时，考虑先压缩图片再插入。

总结

本文介绍了使用Python将图片写入Word文档的多种方法，从基础插入到高级布局，帮助您高效完成办公自动化任务。掌握这一技巧，可以大幅提升文档处理的效率。