使用docxtpl结合Jinja模板动态生成Word表格行时{%tr%}标签失效及样式异常问题求助

我之前用docxtpl做动态Word表格的时候也碰到过一模一样的坑，给你一步步拆解解决方法：

为什么你之前的写法不行？ #

1. 普通Jinja循环挤在同一行 #

你一开始用的普通{% for name in rows %} {{ name }} {% endfor %}，本质是在同一个段落里循环输出内容，自然只会堆在同一行，不会生成新的表格行——毕竟Jinja本身不知道你要操作的是表格行这个Word专属元素。

2. {%tr %}标签写法错误导致报错 #

你试的{%tr for name in rows %} {{ name }} {%tr endfor %}报错，大概率是标签格式或者放置位置不对：docxtpl的表格行循环标签要求{%tr for ... %}和{%tr endfor%}必须分别放在表格行的起始和结束位置，而且不能拆分成多个段落（比如不要把标签拆成两行）。

正确的动态表格行实现方法（完美保留样式） #

这才是docxtpl设计的原生用法，能100%保留你模板表格的样式、边距：

步骤1：制作Word模板 #

打开你的Word模板，找到要动态生成行的表格，添加一行作为「模板行」：

• 在这一行的第一个单元格最开头输入：{%tr for name in rows %}
• 在这一行的最后一个单元格最末尾输入：{%tr endfor%}
• 中间的单元格可以直接放变量，比如要显示名字就写{{ name }}

举个例子，模板表格的一行结构大概是：
| {%tr for name in rows %} | {{ name }} | {%tr endfor%} |

步骤2：Python代码渲染 #

代码和你之前的逻辑差不多，只要把rows列表传入context就行：

from docxtpl import DocxTemplate

# 加载模板
doc = DocxTemplate("你的模板文件.docx")
# 准备数据
context = {
    "rows": ["张三", "李四", "王五"]  # 替换成你的动态数据
}
# 渲染并保存
doc.render(context)
doc.save("生成的文档.docx")

这样生成的每一行都会自动继承原表格的样式、边距，完全不会乱。

关于你手动添加行的方法（为什么格式乱） #

你后来用add_row()的方法，虽然能生成行，但手动复制样式的逻辑有问题：

• Word表格的行索引和Python的索引规则容易混淆，大概率你取错了参考行的样式；
• 手动添加的行默认不会继承表格的整体样式，哪怕复制单个单元格的段落样式，也会漏掉表格行的行高、单元格边距等格式。所以这种方法只适合应急，不推荐用。

内容的提问来源于stack exchange，提问作者Zain Ul Abidin