### 设置图片文字环绕效果 在 `python-docx` 中，目前的版本（截至 0.8.10）并不支持直接设置图片的“文字环绕”效果。该效果在 Word 文档中通常用于实现图片与文本的环绕排版，例如“紧密环绕”、“四周环绕”等样式。然而，`python-docx` 仅支持以内联（Inline Shape）形式插入图片，即图片与文本之间是线性排列的，无法实现浮动图片的环绕效果[^1]。 如果需要设置类似“文字环绕”的效果，可以通过修改文档的 XML 结构来实现浮动图片的插入，从而允许图片与文本重叠并设置环绕样式。具体做法是直接操作 `python-docx` 内部的 XML 元素，向 `document.xml` 中插入浮动图片所需的 XML 标签。 以下是一个示例代码，用于插入浮动图片并设置文字环绕样式： ```python from docx import Document from docx.oxml import OxmlElement from docx.oxml.ns import qn def add_floating_image(paragraph, image_path, width, height, pos_x, pos_y): """ 在段落中插入浮动图片，并设置文字环绕效果 :param paragraph: 段落对象 :param image_path: 图片路径 :param width: 图片宽度 :param height: 图片高度 :param pos_x: 图片水平位置 :param pos_y: 图片垂直位置 """ run = paragraph.add_run() element = run._r drawing = OxmlElement('w:drawing') inline = OxmlElement('wp:inline') extent = OxmlElement('wp:extent') extent.set(qn('cx'), str(int(width * 914400))) extent.set(qn('cy'), str(int(height * 914400))) docPr = OxmlElement('wp:docPr') docPr.set(qn('id'), '1') docPr.set(qn('name'), 'Picture 1') docPr.set(qn('descr'), 'Floating Image') blipFill = OxmlElement('wp:blipFill') blip = OxmlElement('a:blip') blip.set(qn('r:embed'), 'rId1') stretch = OxmlElement('a:stretch') stretch.append(OxmlElement('a:fillRect')) blipFill.append(blip) blipFill.append(stretch) effectExtent = OxmlElement('wp:effectExtent') effectExtent.set(qn('l'), '19050') effectExtent.set(qn('t'), '0') effectExtent.set(qn('r'), '9525') effectExtent.set(qn('b'), '0') wrapSquare = OxmlElement('wp:wrapSquare') wrapSquare.set(qn('wrapText'), 'bothSides') inline.append(extent) inline.append(docPr) inline.append(blipFill) inline.append(effectExtent) inline.append(wrapSquare) drawing.append(inline) element.append(drawing) doc = Document() paragraph = doc.add_paragraph("这是一个测试段落，图片将浮动在文本上方，并设置文字环绕效果。") add_floating_image(paragraph, 'image.jpg', width=4.0, height=3.0, pos_x=1.0, pos_y=1.0) doc.save('floating_image.docx') ``` 上述代码通过手动构造 XML 元素实现了浮动图片的插入，并设置了 `wp:wrapSquare` 标签来实现文字环绕效果。其中 `wrapText` 属性用于指定环绕方式，可选值包括 `bothSides`（两侧环绕）、`left`（左侧环绕）和 `right`（右侧环绕）等[^1]。 需要注意的是，这种做法需要对 `python-docx` 的 XML 结构有较深的理解，并且可能在不同版本中存在兼容性问题。因此，在使用该方法时应确保代码的稳定性，并进行充分测试。 --- ###