### 使用 python-docx 创建带表格题注的 Word 文档 为了实现这一目标，可以利用 `python-docx` 的功能来创建文档、添加表格以及为其设置题注。下面展示一段示例代码，该代码能够新建一个包含表格及其对应题注的 `.docx` 文件。 ```python from docx import Document from docx.shared import Pt, Inches from docx.oxml.ns import qn from docx.oxml import OxmlElement def add_caption(paragraph, label="Table", title="untitled"): run = paragraph.add_run(f"{label} {title}") r = run._r fldChar = OxmlElement('w:fldSimple') #{http://schemas.openxmlformats.org/wordprocessingml/2006/main}fldSimple fldChar.set(qn('w:instr'), f' SEQ {label.lower()} \\* ARABIC ') r.insert_element_before( fldChar, 'w:t', 'w:commentRangeStart', 'w:commentRangeEnd', 'w:rPr' ) document = Document() # 添加段落作为表前描述文字 p = document.add_paragraph('以下是本报告中的第一个数据表') # 插入表格 table = document.add_table(rows=1, cols=3) hdr_cells = table.rows[0].cells hdr_cells[0].text = '编号' hdr_cells[1].text = '名称' hdr_cells[2].text = '备注' # 给表格加边框样式 (可选操作) for row in table.rows: for cell in row.cells: tc = cell._tc tcPr = tc.get_or_add_tcPr() borders = OxmlElement('w:borders') border_t = OxmlElement('w:top') border_b = OxmlElement('w:bottom') border_l = OxmlElement('w:left') border_r = OxmlElement('w:right') border_t.set(qn('w:val'),'single') border_b.set(qn('w:val'),'single') border_l.set(qn('w:val'),'single') border_r.set(qn('w:val'),'single') borders.append(border_t) borders.append(border_b) borders.append(border_l) borders.append(border_r) tcPr.append(borders) # 设置字体大小 style = document.styles['Normal'] font = style.font font.name = u'Times New Roman' font.size = Pt(12) # 增加新段落后紧跟表格放置题注 caption_para = document.add_paragraph(style='Caption') add_caption(caption_para,label="表",title="样本数据") # 保存文件 document.save('./example.docx') ``` 此段脚本首先定义了一个辅助函数 `add_caption()` 来处理题注的具体格式化工作；接着通过调用 `Document().add_table()` 方法构建所需表格结构，并对其应用简单的样式调整；最后，在紧随其后的段落位置处插入由上述自定义方法生成的题注[^1]。