如何通过函数创建Table对象并添加至docx文档？

你遇到的TypeError是因为python-docx的Table类不能直接用rows、cols参数实例化——它的构造函数需要关联文档内部的XML结构，不能单独创建独立的Table对象。

正确的重构方式有两种，选适合你的就行：

方式一：让函数负责创建并配置表格 #

把文档对象传入函数，在函数内部通过doc.add_table()创建表格，再完成内容填充：

from docx import Document

document = Document()

def build_mytable(doc, mydata):
    # 函数内部通过文档对象创建表格
    table = doc.add_table(rows=1, cols=4)
    # 这里写表格构建逻辑，比如根据mydata填充内容
    header_cells = table.rows[0].cells
    header_cells[0].text = mydata.get("col1", "")
    header_cells[1].text = mydata.get("col2", "")
    # 更多表格处理代码，比如添加行、设置样式等
    return table

# 调用函数生成表格
build_mytable(document, {"col1": "第一列", "col2": "第二列"})
build_mytable(document, {"col1": "测试内容1", "col2": "测试内容2"})

document.save('foo.docx')

方式二：拆分表格创建与内容填充 #

如果想把“创建表格”和“填充内容”的逻辑分开，可以让函数只接收表格对象和数据，负责内容配置：

from docx import Document

document = Document()

def populate_table(table, mydata):
    # 只处理表格内容，表格由外部创建
    header_cells = table.rows[0].cells
    header_cells[0].text = mydata.get("col1", "")
    # 更多填充逻辑...

# 先创建表格，再传入函数处理
table1 = document.add_table(rows=1, cols=4)
populate_table(table1, somedata)

table2 = document.add_table(rows=1, cols=4)
populate_table(table2, someotherdata)

document.save('foo.docx')

本质原因是：python-docx的Table对象依赖文档的XML上下文，必须通过Document.add_table()方法创建，这个方法会自动处理底层的XML元素关联，直接调用Table.__init__缺少必要的初始化参数，所以会触发错误。

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