如何在docx文档中添加分页符？求助修正失效的Python代码

我需要给Word（docx）文档添加分页符，让每个问题及其对应的文本、图片都单独占一页。

文档现状 #

未修改的文档中，多个问题连续排列，跨页时问题的内容（文本、图片）会被拆分到不同页面。

期望效果 #

每个问题（包含其下方的所有文本、图片内容）完整显示在单独一页，新问题从新页面开头开始。

我尝试的代码（未成功） #

def page_break(document):
    page_break_lines = []
    contador = 0

    for pa4 in document.paragraphs:
        text = pa4.text.strip()
        if text:
            if text[0].isdigit() and (text[1] == ')' or text[1] == '.'):
                contador += 1
                if contador > 1:
                    pa4.runs[0].add_break(WD_BREAK.PAGE)
                    contador = 0
                else:
                    contador = 0
        page_break_lines.append(pa4)

    return page_break_lines

问题分析 #

原代码逻辑存在以下问题：

• 计数变量contador逻辑混乱，识别到问题后反复重置，无法正确判断是否为第二个及以后的问题
• 在段落的第一个run中添加分页符，可能导致分页符插入到问题文本中间，而非段落开头
• 未考虑图片段落的关联逻辑（图片属于段落内嵌元素，只要保证问题段落前加分页符，后续内容会自动跟随）

修正后的代码 #

from docx import Document
from docx.enum.text import WD_BREAK

def add_page_breaks_per_question(document):
    is_first_question = True
    for para in document.paragraphs:
        text = para.text.strip()
        # 识别问题开头：以数字+）或.开头的非空文本
        if text and len(text) >= 2 and text[0].isdigit() and (text[1] == ')' or text[1] == '.'):
            if not is_first_question:
                # 非第一个问题，在当前段落前插入分页符
                para.insert_paragraph_before().add_run().add_break(WD_BREAK.PAGE)
            is_first_question = False
    return document

# 使用示例
doc = Document("your_document.docx")
doc = add_page_breaks_per_question(doc)
doc.save("document_with_page_breaks.docx")

代码说明 #

• 遍历文档所有段落，精准识别问题开头格式（数字+）或.）
• 第一个问题不做处理，从第二个问题开始，在其段落前插入空段落并添加分页符，确保问题从新页面启动
• 图片和后续文本属于问题段落的关联内容，会自动跟随到新页面，保证每个问题的内容完整占据一页

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