如何使用Python构造Word表格并插入docx-template指定占位符位置

问题描述 #

需要用Python构造带有复杂格式（如单元格合并、空白行分隔）的Word表格，并将其插入到docx-template模板的指定占位符位置。已知Jinja2标签渲染基础表格的方式，但因表格逻辑复杂，更倾向于直接用Python构造表格而非Jinja2。

实现方案 #

可以通过docx-template结合python-docx的API实现，核心思路是：先在模板中设置占位符，构造好表格后，找到占位符所在段落，将表格插入该位置并替换占位符。

步骤1：准备模板 #

在template.docx中添加一个段落，内容为{{ table_placeholder }}，作为表格的插入位置标记。

步骤2：完整代码实现 #

from docxtpl import DocxTemplate
from docx.table import Table
from docx.shared import Pt

doc = DocxTemplate('template.docx')

items = [
    {'column1': 'Item 1-1', 'column2': 'Item 1-2', 'column3': 'Item 1-3'},
    {'column1': 'Item 2-1', 'column2': 'Item 2-2', 'column3': 'Item 2-3'},
    {'column1': 'Item 3-1', 'column2': 'Item 3-2', 'column3': 'Item 3-3'}
]

rows = []
for item in items:
    row = [item['column1'], item['column2'], item['column3']]
    rows.append(row)

# 构造带复杂格式的表格
table = Table(len(rows)+1, 3)

# 设置表头样式
header_cells = table.rows[0].cells
header_cells[0].text = 'Column 1'
header_cells[1].text = 'Column 2'
header_cells[2].text = 'Column 3'
for cell in header_cells:
    run = cell.paragraphs[0].runs[0]
    run.font.bold = True
    run.font.size = Pt(12)

# 填充数据行，添加空白行分隔示例
for i, row in enumerate(rows):
    row_cells = table.rows[i+1].cells
    row_cells[0].text = row[0]
    row_cells[1].text = row[1]
    row_cells[2].text = row[2]
    # 每2行后插入空白行（最后一行不添加）
    if (i+1) % 2 == 0 and i+1 < len(rows):
        blank_row = table.add_row()
        # 清空空白行单元格内容
        for cell in blank_row.cells:
            cell.text = ''

# 插入表格到模板占位符位置
# 先渲染模板，清除占位符文本
context = {'table_placeholder': ''}
doc.render(context)
document = doc.get_docx()

# 查找占位符段落并替换为表格
for paragraph in document.paragraphs:
    if '{{ table_placeholder }}' in paragraph.text:
        p_element = paragraph._p
        # 将表格插入到当前段落的位置
        p_element.addprevious(table._tbl)
        # 删除原占位符段落
        p_element.getparent().remove(p_element)
        break

doc.save('output.docx')

关键说明 #

• 复杂表格构造：可以直接通过Table对象的API实现单元格合并（如table.cell(row_start, col_start).merge(table.cell(row_end, col_end))）、样式设置等逻辑，完全满足自定义需求。
• 占位符替换：通过遍历文档段落找到标记位置，利用python-docx内部的XML元素（_p表示段落，_tbl表示表格）完成插入操作，确保表格准确放置在指定位置。
• 样式扩展：可以进一步为表格添加边框、背景色等样式，通过table.style或单元格的_tc元素进行设置。

内容的提问来源于stack exchange，提问作者Greenjoy