如何用Python的docx包避免表格跨页，使其完整显示在单页？

要让表格完整显示在单页，核心是控制表格段落的分页属性，autofit相关设置是控制列宽的，和跨页问题无关，以下是可行的解决方案：

方法一：设置表格段落的"同页"属性 #

遍历表格所有单元格的段落，开启与下段同页和段落内不换行，确保表格行不会被拆分到两页。注意最后一行要取消"与下段同页"，避免影响后续内容：

from docx import Document

def fix_table_page_break(doc):
    # 处理所有表格
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                    # 段落内不拆分
                    para.paragraph_format.keep_together = True
                    # 与下一段落同页
                    para.paragraph_format.keep_with_next = True
    # 取消最后一个表格最后一行的"与下段同页"
    if doc.tables:
        last_table = doc.tables[-1]
        last_row = last_table.rows[-1]
        for cell in last_row.cells:
            for para in cell.paragraphs:
                para.paragraph_format.keep_with_next = False

# 示例使用
doc = Document()
# 这里添加你的内容和表格逻辑
# ...
fix_table_page_break(doc)
doc.save("fixed_document.docx")

方法二：手动插入分页符（适合特定场景） #

如果某个表格总是出现在页尾，可以在表格前强制插入分页符，确保表格从新页开始：

from docx.enum.text import WD_BREAK

# 在目标表格前插入分页符
doc.add_paragraph().add_run().add_break(WD_BREAK.PAGE)
# 然后创建表格
table = doc.add_table(rows=5, cols=2)
# 填充表格内容...

关键说明 #

• keep_together：确保单个段落不会被拆分到两页
• keep_with_next：确保当前段落和下一段落在同一页，让表格行不会被拆分
• 最后一行取消keep_with_next是为了避免把表格后的内容也强制拉到同一页

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