Word 文档模板填充指南

概述

本指南介绍如何使用 Python 向 Word（.docx）模板填充动态数据。支持：

• 普通占位符：{variable_name} 替换文本
• 智能表格填充：使用 {name|r:x,c:y} 标记在表格左侧任意位置，自动从标记行向下填充，保留上方内容，并自动调整表格行列数

⚠️ 1. 表格自动调整的时机与条件

表格并非总是"提前自动扩展" - 这取决于占位符是否被正确识别：

• ✅ 会被自动调整的情况：当且仅当 {name|r:x,c:y} 格式完全正确且位于**该行的最左侧单元格（第一列）**时，表格会在 DocxTemplateFiller 初始化时立即调整为声明的行列数
• ❌ 不会被调整的情况：如果占位符格式错误、包含空格（如 {name | r:5, c:4}）、或不在第一列，表格将保持原样，不会自动扩展或收缩

⚠️ 2. 普通占位符一般情况下需要被覆盖！

• 除非未提供值时保留原样