如何让python-docx中的表格标题与表格不被跨页拆分？

要让表格标题和表格始终处于同一页面，可以通过以下关键设置实现：

1. 给标题段落设置keep_with_next属性 #

将标题段落的keep_with_next设为True，这会强制该段落与后续元素（即表格）保持在同一页面，避免被拆分到不同页。

修改后的代码示例：

from docx import Document

document = Document()

# 添加表格标题段落并设置keep_with_next
p = document.add_paragraph()
run = p.add_run('Table 1.1 -- Caption Text')
p.paragraph_format.keep_with_next = True

# 添加表格
table = document.add_table(rows=2, cols=4)

2. 处理长表格的特殊情况 #

如果表格本身长度超过一页，即使设置了标题的keep_with_next，标题会和表格前半部分留在同一页，表格后半部分自动分页（这属于正常排版逻辑）。若表格内容能容纳在单页，可禁止表格内部分页：

# 禁止表格内部分页（仅适合短表格）
table.allow_page_break = False

注意：若表格内容确实超出单页范围，不建议强制禁止内部分页，否则会导致内容截断或排版错乱。

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