Python-docx 批量生成带图营销文：文字图片分离与排版定位

1. 引言

在批量生成营销文案时，经常需要在 Word 文档中同时插入文字和图片。如果直接把图片和文字混在一起处理，容易出现图片位置错乱、排版不稳定等问题。本文介绍一种「文字图片分离」的思路：先统一写入文字内容，再集中处理图片的插入与定位，从而让 Python-docx 生成的带图营销文排版更可控、更稳定。

2. 核心思路：文字与图片分离

所谓「文字图片分离」，是指在构建文档时，把文字内容和图片内容分开处理，而不是边写文字边插图片。这样做的好处有三个：

结构清晰：文字部分负责内容表达，图片部分负责视觉呈现，互不干扰。
定位可控：图片可以统一按锚点或占位符定位，避免因文字长度变化导致图片漂移。
便于维护：后续替换图片或调整文案时，只需修改对应部分，不需要重排整篇文档。

3. 环境准备

首先安装 python-docx 库：

bash 复制代码

pip install python-docx

然后导入所需模块：

python 复制代码

from docx import Document
from docx.shared import Inches, Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT

4. 文字图片分离的实现方式

实现分离的核心是「先写文字，后插图片」。具体做法是：先用占位符标记图片位置，待文字全部写入后，再根据占位符统一插入图片。

4.1 使用占位符标记图片位置

在文字段落中预留形如 {``{image:1}} 的占位符，后续通过查找占位符来定位图片插入点。

python 复制代码

def add_text_with_placeholder(doc, text):
    """写入带图片占位符的文字段落"""
    p = doc.add_paragraph()
    p.add_run(text)
    return p

4.2 根据占位符插入图片

遍历文档中的所有段落，找到包含占位符的段落，在对应位置插入图片。

python 复制代码

def insert_images_by_placeholder(doc, image_map):
    """根据占位符批量插入图片
    image_map: {占位符: 图片路径}
    """
    for paragraph in doc.paragraphs:
        for placeholder, image_path in image_map.items():
            if placeholder in paragraph.text:
                run = paragraph.add_run()
                run.add_picture(image_path, width=Inches(5))
                # 清除占位符文本
                paragraph.text = paragraph.text.replace(placeholder, '')
                break

5. 图片排版定位技巧

插入图片后，还需要控制图片的对齐方式和大小，才能让排版更美观。

5.1 设置图片居中

通过设置段落对齐方式，可以让图片在文档中居中显示。

python 复制代码

def add_centered_image(doc, image_path, width_inches=5):
    """插入居中图片"""
    p = doc.add_paragraph()
    p.alignment = WD_ALIGN_PARAGRAPH.CENTER
    run = p.add_run()
    run.add_picture(image_path, width=Inches(width_inches))
    return p

5.2 控制图片与文字的距离

通过调整段落间距，可以让图片与上下文字保持合适的距离。

python 复制代码

def set_paragraph_spacing(paragraph, before=6, after=6):
    """设置段落前后间距（单位：磅）"""
    paragraph.paragraph_format.space_before = Pt(before)
    paragraph.paragraph_format.space_after = Pt(after)

6. 完整示例：批量生成带图营销文

下面给出一个完整的示例，演示如何批量生成多篇带图营销文。

python 复制代码

from docx import Document
from docx.shared import Inches, Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH
def generate_marketing_doc(title, content_list, image_map, output_path):
"""生成一篇带图营销文
content_list: [(文字内容, 图片占位符或None), ...]
image_map: {占位符: 图片路径}
"""
doc = Document()
# 写入标题
doc.add_heading(title, level=0)
写入正文和图片
for text, placeholder in content_list:
p = doc.add_paragraph()
p.add_run(text)
if placeholder and placeholder in image_map:
# 插入图片并居中
p.alignment = WD_ALIGN_PARAGRAPH.CENTER
run = p.add_run()
run.add_picture(image_map[placeholder], width=Inches(5))
doc.save(output_path)
print(f"已生成: {output_path}")
批量生成示例
if name == "main":
articles = [
{
"title": "夏季新品上市",
"content": [
("炎炎夏日，新品清凉上市。", "{{img:1}}"),
("限时优惠，欢迎选购。", None),
],
"images": {"{{img:1}}": "summer.jpg"},
"output": "summer_sale.docx",
},
{
"title": "秋季护肤指南",
"content": [
("秋季干燥，护肤正当时。", "{{img:2}}"),
("精选保湿系列，呵护肌肤。", None),
],
"images": {"{{img:2}}": "autumn.jpg"},
"output": "autumn_skincare.docx",
},
]
for article in articles:
generate_marketing_doc(
article["title"],
article["content"],
article["images"],
article["output"],
)</code></pre>
7. 常见问题与注意事项
占位符冲突：占位符命名要足够独特，避免与正文文字冲突。
图片路径：确保图片路径正确，否则会抛出 FileNotFoundError。
图片大小：建议统一设置图片宽度，避免文档中图片大小不一影响美观。
批量性能：生成大量文档时，建议使用循环批量处理，并做好异常捕获。
8. 总结
通过「文字图片分离」的思路，可以显著提升 Python-docx 批量生成带图营销文的排版稳定性。核心要点是：先用占位符标记图片位置，再统一插入图片并控制对齐和间距。这样即使文字内容变化，图片位置也不会轻易漂移，整体排版更加可控。