同一份 Word 的横版表格页，别按整篇统一改方向

本文使用合成样本演示处理方法。代码已通过隔离环境中的示例检查；这不代表对所有真实文件或产品效果的保证。处理重要文件前，请保留原件，并按文中的边界与验收项复核。 这篇先解决哪一个问题 构造全部节之后重新按索引取得目标节，避免把新增分节前保存的末节对象误当成原来的节。方向与页面宽高分别设置，并在保存后重新读取检查其他节未被改变。 自包含的合成示例 依赖见导入列表。代码在内存中构造输入；运行记录单独提供，不代表对所有真实文件的保证。 from docx import Document from docx.enum.section import WD_ORIENT, WD_SECTION from io import BytesIO doc = Document() doc.add_paragraph("Portrait intro") doc.add_section(WD_SECTION.NEW_PAGE) doc.add_paragraph("Landscape middle") doc.add_section(WD_SECTION.NEW_PAGE) doc.add_paragraph("Portrait end") middle = doc.sections[1] width, height = middle.page_width, middle.page_height middle.orientation = WD_ORIENT.LANDSCAPE middle.page_width, middle.page_height = max(width, height), min(width, height) out = BytesIO() doc.save(out) out.seek(0) restored = Document(out) assert len(restored.sections) == 3 assert restored.sections[1].orientation == WD_ORIENT.LANDSCAPE assert restored.sections[1].page_width > restored.sections[1].page_height assert restored.sections[0].orientation == WD_ORIENT.PORTRAIT assert restored.sections[2].orientation == WD_ORIENT.PORTRAIT 在Word文档自动化处理中，将特定宽表格页设为横向而保持其余页面纵向，是最容易踩坑的需求之一。许多开发者尝试直接修改段落或表格属性，结果要么整篇文档变成横版，要么表格旋转后内容溢出被裁切。根本原因在于混淆了“分页符”（Page Break）与“分节符”（Section Break）：分页符仅控制内容换行，不携带任何版面属性；而页面方向、纸张尺寸、页边距等设置，全部严格绑定在“节”（Section）这个容器上。要实现局部横向，必须在目标内容前后插入分节符，并精准修改该节的属性。 分节符才是版面属性的真正载体 在OpenXML标准中， <w:sectPr> 元素定义了页面布局。一个文档可以包含多个节，每个节独立拥有自己的宽高、方向和边距配置。当你调用 document.add_section() 时，python-docx会在当前文档末尾创建一个新的 <w:sectPr> ，后续添加的内容自动归属到这个新节。如果试图通过修改段落样式或表格属性来改变方向，注定失败，因为这些对象根本没有存储版面信息的字段。 理解这一点后，操作逻辑就变得清晰：先定位到需要旋转的内容范围，确保它被包裹在独立的节中，然后交换该节的宽高值并将orientation设为LANDSCAPE。注意，仅仅设置orientation而不交换宽高，Word在打开时会显示错误的纸张尺寸，导致打印或导出PDF时内容被裁切。这是新手最常犯的错误，也是本文强调的核心要点。 合成示例：正确旋转与常见边界错误 以下为一组 合成示例 ，用于演示预期行为与错误处理，并非真实业务数据。若需处理外部文件，请使用 Document('path/to/file.docx') 加载，并确保文件未加密且结构完整。 正确输入场景 ：文档包含三节，第一节纵向正文，第二节需放置宽表格，第三节恢复纵向。预期输出是第二节 orientation 为LANDSCAPE，且 page_width 大于 page_height ，其余两节保持PORTRAIT不变。 错误/边界输入 ：传入一个从未显式分节的单节文档，直接对 sections[0] 执行横向设置。此时若不加判断地修改，会导致全文档变横。正确处理方式是先检查节数量，若只有一节且需求仅是局部旋转，应先调用 add_section() 拆分内容，再对新生成的节进行操作。另一个边界是宽高未交换：设置了LANDSCAPE但保留了原纵向尺寸，代码应强制校验 page_width >= page_height 作为前置断言。 python-docx 局部横向设置代码实现 以下示例展示如何在内存中构造一个三节文档，并将中间节安全地设为横向。依赖库为 python-docx ，请在锁定的项目环境中运行，版本需支持 WD_ORIENT 枚举（0.8.11及以上）。示例不包含文件读写，所有对象均在内存构建，读者可自行替换为真实文件路径进行测试。 验收清单与人工审查边界 代码能解决结构明确的文档，但现实文件常有意料之外的状态。下表列出关键验收点及何时应放弃自动化： 观察现象 处理决定 是否适用代码演示 目标页前后无分节符 先用 add_section() 拆分，再设方向 是 设置横向后表格仍被截断 检查该节左右边距是否过大，或表格宽度超纸张 否，需调整边距或表格 文档含连续分节符且方向异常 连续分节符不换页，可能导致视觉混乱，建议转为下一页分节符 部分适用，需人工判断分节类型 节数量为0或访问报IndexError 用 len(sections) 预检，或try-except兜底 是 页眉页脚在横向页错位 节属性变更不影响页眉链接状态，需单独检查header/footer距离 否，属独立问题 明确不适用范围：加密文档、损坏的XML结构、使用宏动态生成节的模板文件。这些情况应先人工修复或转换格式。代码演示仅验证API调用逻辑，端到端效果必须在Word或PDF导出后肉眼确认。 参考与下一步 python-docx Sections 官方文档 将这份检查清单用于文档翻译 Word 翻译容易把内容问题与格式问题混在一起。把样式、页眉和表格等检查项留到交付清单里，让审校知道该在哪里检查。 OmniDoc（产品入口） 提供多格式文档翻译入口，官网介绍了 OCR、术语表与双语对照功能。对希望直接从文件开始处理的团队，这是一条值得用实际样本评估的路径。请使用有权上传的脱敏文件，并用本篇的检查项复核结果；这里不声称 OmniDoc 使用了本文的开源库或内部算法，也不以示例代替产品性能测试。 - 1 -