在使用 `python-docx` 库添加图片时，默认情况下图片的布局受页面边距限制。如果希望图片能够超出页边距显示，需要通过调整文档的页面布局设置，例如增加页面宽度或调整边距[^1]。 ### 设置图片超出页边距显示的方法 1. **调整页面边距** 通过 `python-docx` 可以修改页面的左右边距，从而为图片提供更大的显示空间。以下代码示例演示如何设置文档的页面边距： ```python from docx import Document from docx.shared import Inches doc = Document() sections = doc.sections for section in sections: section.left_margin = Inches(0.5) # 设置左边距为 0.5 英寸 section.right_margin = Inches(0.5) # 设置右边距为 0.5 英寸 paragraph = doc.add_paragraph() run = paragraph.add_run() run.add_picture('image.jpg') doc.save('wide_image.docx') ``` 上述代码通过调整页面的左右边距，为图片留出更多空间，从而实现图片超出默认边距显示的效果[^1]。 2. **调整图片宽度** 如果图片的宽度大于页面内容区域的宽度（页面宽度减去左右边距），图片会自动被截断。因此，可以通过动态调整图片的宽度来适应页面布局。以下代码示例演示如何设置图片宽度： ```python from docx import Document from docx.shared import Inches doc = Document() paragraph = doc.add_paragraph() run = paragraph.add_run() run.add_picture('image.jpg', width=Inches(8.0)) # 设置图片宽度为 8 英寸 doc.save('wide_image.docx') ``` 通过指定 `width` 参数，可以控制图片的宽度，使其尽可能填满页面内容区域，甚至略微超出边距限制。 3. **结合页面布局调整** 如果需要图片完全超出页边距显示，可以进一步调整页面尺寸。例如，通过设置页面宽度为更大的值，以容纳更宽的图片： ```python from docx import Document from docx.shared import Inches from docx.enum.section import WD_SECTION doc = Document() section = doc.sections[0] section.page_width = Inches(12.0) # 设置页面宽度为 12 英寸 paragraph = doc.add_paragraph() paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER # 设置段落居中对齐 run = paragraph.add_run() run.add_picture('image.jpg', width=Inches(10.0)) # 设置图片宽度为 10 英寸 doc.save('wide_image.docx') ``` 通过调整页面宽度和图片宽度，可以实现图片超出页边距的效果。 --- ### 注意事项 - 调整页面边距和宽度时，需确保文档的整体布局仍然符合预期，避免图片显示不完整或被截断。 - 图片的宽度不应超过页面的实际宽度（页面宽度减去边距），否则图片可能会被截断。 - 使用 `python-docx` 时，所有图片的插入操作都必须依赖 `Run` 对象。 --- ###