使用Python docxtpl模板填充动态表格并设置边框属性的最佳方案

使用DocxTemplate生成列固定、行动态的Word表格时，会出现动态插入行无法继承表格样式的问题，尤其是粗灰色外边框的左侧、底部区域缺失，效果对比如下：

以下是两种可行的实现思路： #

思路1：模板端调整（优先推荐，无需额外编码） #

• 打开你的dynamic_table_tpl.docx模板文件，先创建符合样式要求的基准表格：提前设置好全表的粗灰色外边框、表头/内容行的内部边框样式，确认整表的边框属性是应用到「表格」而非个别单元格
• 表格保留固定表头，下方仅保留1行空白内容行作为基准行，不需要提前预留多余空行
• 替换模板里的表格内容为docxtpl原生的表格循环标签，示例模板的表格结构如下：

  Description	Company Number	Calibration Due Date
  {% for row in tbl_contents %} {{ row.cols[0] }}	{{ row.cols[1] }}	{{ row.cols[2] }} {% endfor %}

  原生表格行循环语法会自动继承基准行的样式，不会出现边框丢失问题
• 渲染时不需要额外处理行插入，直接传入现有context即可。

思路2：代码端强制补全边框（适合无法修改模板的场景） #

docxtpl渲染完成后可以直接调用python-docx的API修改表格边框，你可以在渲染代码后增加边框修正逻辑，示例代码如下：

from docx.shared import Pt
from docx.oxml.ns import qn
from docx.oxml import OxmlElement

tpl = DocxTemplate('G:\ELECSUPP\Documentation\Results\Kaya Marks/dynamic_table_tpl.docx')

context = {
    'col_labels': ['Description', 'Company Number', 'Calibration \nDue Date'],
    'tbl_contents': [
        {'label': '1', 'cols': ['Desc', 'BXXXXXX', '12/12/21']},
        {'label': '2', 'cols': ['Desc', 'BXXXXXX', '10/01/22']},
        {'label': '3', 'cols': ['Desc', 'BXXXXXX', '10/10/10']},  
    ],
}

# 先执行渲染
tpl.render(context)

# 修正第一个表格的边框（如果有多个表格可以调整索引）
tbl = tpl.docx.tables[0]
# 给所有最左列单元格设置左边框（粗灰色）
for row in tbl.rows:
    cell = row.cells[0]
    tcPr = cell._tc.get_or_add_tcPr()
    lnLeft = OxmlElement('w:left')
    lnLeft.set(qn('w:val'), 'single')
    lnLeft.set(qn('w:sz'), '24') # 线宽单位为1/20磅，24对应1.2磅，可按需调整
    lnLeft.set(qn('w:color'), '888888') # 灰色十六进制值，可按需修改
    tcPr.append(lnLeft)

# 给最后一行所有单元格设置下边框（粗灰色）
last_row = tbl.rows[-1]
for cell in last_row.cells:
    tcPr = cell._tc.get_or_add_tcPr()
    lnBottom = OxmlElement('w:bottom')
    lnBottom.set(qn('w:val'), 'single')
    lnBottom.set(qn('w:sz'), '24')
    lnBottom.set(qn('w:color'), '888888')
    tcPr.append(lnBottom)

# 保存文件
tpl.save('生成结果.docx')

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