如何使用Python在Word文档指定段落后插入表格

问题核心是python-docx的add_table()方法默认会在文档末尾添加表格，要插入到指定段落（比如第85段）之后，需要操作底层XML元素调整位置。

修改后的完整代码 #

from docx import Document
from docx.oxml import OxmlElement
from docx.oxml.ns import qn
import pandas as pd

def set_cell_margins(cell, **kwargs):
    """设置单元格边距"""
    tc = cell._tc
    tcPr = tc.get_or_add_tcPr()
    tcMar = OxmlElement('w:tcMar')

    for m in ["top", "start", "bottom", "end"]:
        if m in kwargs:
            node = OxmlElement(f"w:{m}")
            node.set(qn('w:w'), str(kwargs.get(m)))
            node.set(qn('w:type'), 'dxa')
            tcMar.append(node)

    tcPr.append(tcMar)

def create_table(document, df, table_style='Table Grid'):
    """创建表格并返回，不直接添加到文档末尾"""
    columns = list(df.columns)
    # 创建表格（此时表格还未加入文档）
    table = document.add_table(rows=1, cols=len(columns), style=table_style)
    table.autofit = True
    # 设置表头
    for col in range(len(columns)):
        set_cell_margins(table.cell(0, col), top=50, start=50, bottom=50, end=50)
        table.cell(0, col).text = columns[col].replace("_", " ").capitalize()
    # 填充数据
    for _, row in enumerate(df.itertuples()):
        table_row = table.add_row().cells
        for col in range(len(columns)):
            set_cell_margins(table_row[col], top=50, start=50, bottom=50, end=50)
            table_row[col].text = str(row[col + 1])
    return table

# 加载现有文档
doc = Document(path_to_docx)
# 读取Excel数据
hr_df = pd.read_excel(latest_file, engine="openpyxl")
hr_df = hr_df[['id', 'summary']]

# 添加标题文本
text = f"Changelog  {lines[0]} (Integrated CRs):"
add_text(doc, text + "\n\n")

# 获取目标段落（索引从0开始，确认实际位置是否匹配）
target_paragraph = doc.paragraphs[85]
# 创建表格
table = create_table(doc, hr_df.iloc[:100])
# 将表格插入到目标段落之后
target_paragraph._p.addnext(table._tbl)

# 在表格后添加空段落
target_paragraph._p.addnext(OxmlElement('w:p'))

# 保存文档
doc.save(path_to_docx)

关键修改说明 #

1. 拆分逻辑：把原函数拆分为表格创建与插入两步，生成表格对象后再指定插入位置，避免默认添加到文档末尾。
2. 定位目标段落：通过doc.paragraphs[85]获取插入位置，注意段落索引从0开始，需确认目标段落的实际索引是否正确。
3. 底层XML操作：利用段落的_p属性（对应Word的<w:p>元素）调用addnext()，将表格的_tbl属性（对应Word的<w:tbl>元素）插入到目标段落的下一个位置。
4. 空段落补充：若需要表格后留白，可插入空的<w:p>元素。

注：确保path_to_docx、latest_file、lines和add_text函数已正确定义。

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