Python + Spire.Doc 实现Word图片插入与图文排版：内联与浮动定位详解

脚本专家

在自动化生成商务报告、技术白皮书或产品手册时，图文混排是提升文档专业度的关键。手动插入图片不仅效率低，且难以保证多文档排版一致性。借助 Python 和 Spire.Doc for Python 库，开发者可以直接操作 Word 对象模型，实现图片的批量插入、尺寸控制、文字环绕样式设置以及绝对坐标定位。

环境搭建
首先通过 pip 安装 Spire.Doc 库（无需依赖 Microsoft Office）：

2. pip install Spire.Doc

复制代码

安装后可在脚本中引入 Document、TextWrappingStyle 等核心类。

核心原理：内联图片 vs 浮动图片
Word 底层将图片分为两种布局：
- 内联（Inline）：图片作为段落中的特殊字符，随文本流排版。若将环绕方式设为嵌入型，手动设置的水平和垂直绝对坐标无效。
- 浮动（Floating）：图片脱离文本流，可放置在页面任意位置。通过设置环绕样式（如四周型 Square、穿透型 Through 等）实现文字绕排。

向段落插入图片并设置文字环绕
以下代码演示如何在已有文本段落末尾插入图片，并指定其尺寸与“四周型”环绕：

2. from spire.doc import *
3. from spire.doc.common import *
5. document = Document()
6. section = document.AddSection()
7. paragraph = section.AddParagraph()
8. tr = paragraph.AppendText("Spire.Doc for Python 是一款独立专业的 Python Word 开发组件。")
9. tr.CharacterFormat.FontName = "宋体"
10. tr.CharacterFormat.FontSize = 11
12. picture = paragraph.AppendPicture("/Logo.png")
13. picture.Width = 100
14. picture.Height = 100
15. picture.TextWrappingStyle = TextWrappingStyle.Square
17. document.SaveToFile("/output/Word图片.docx", FileFormat.Docx)
18. document.Close()

复制代码

关键点：
- AppendPicture 将图片绑定到指定段落末尾。
- Width/Height 控制图片显示尺寸（单位：磅），防止大图撑破版面。
- TextWrappingStyle.Square 启用四周型环绕，文本沿图片矩形边界自动排列。

精确控制图片的绝对位置
若需将图片固定在页面的特定坐标（如公司 Logo 固定在距左上角固定距离），需将图片设为浮动并指定偏移量：

2. from spire.doc import *
3. from spire.doc.common import *
5. doc = Document()
6. section = doc.AddSection()
7. paragraph = section.AddParagraph()
8. paragraph.AppendText("此示例演示在 Word 文档指定位置插入图片。")
9. paragraph.ApplyStyle(BuiltinStyle.Heading1)
11. picture = paragraph.AppendPicture("/Logo.png")
12. picture.HorizontalPosition = 150.0
13. picture.VerticalPosition = 60.0
14. picture.Width = 30.0
15. picture.Height = 45.0
16. picture.TextWrappingStyle = TextWrappingStyle.Through
18. doc.SaveToFile("/output/插入图片.docx", FileFormat.Docx)
19. doc.Close()

复制代码

关键点：
- HorizontalPosition / VerticalPosition 控制图片距页面左边缘和上边缘的偏移（浮点型，单位磅）。
- 必须将 TextWrappingStyle 设为非嵌入型（此处用 Through 穿透型），否则坐标值会被忽略。
- 穿透型环绕使文本贴合图片几何轮廓排列。

实用图文编排技巧
1. 环绕样式互斥：若显式将 TextWrappingStyle 设为 Inline（嵌入型），则 HorizontalPosition 和 VerticalPosition 坐标设置无效。只有切换到 Square、Through、TopAndBottom 等浮动样式时，绝对定位才生效。
2. 清除文档中的图片：遍历段落子元素集合（ChildObjects），筛选类型为 DocPicture 的实例并调用移除方法，可快速从文档中批量删除所有插图。

总结
通过 Spire.Doc for Python 的面向对象 API，开发者可以高效实现 Word 图文排版自动化。利用 AppendPicture 插入图片，配合 Width、Height 控制尺寸，以及 TextWrappingStyle 和坐标属性，无论是内联插图还是需精确定位的浮动元素，都能在脚本中精准操控。该技术适用于电子合同自动配图、体检报告图表合成、商品画册批量排版等工业级场景，替代手动调整，显著提升效率。

热心网友6

感谢分享！这篇教程很实用，尤其是明确区分内联和浮动图片的部分，之前自己试的时候经常发现坐标设置不生效，原来是因为环绕样式没改过来。另外“穿透型”环绕之前接触得少，看了示例才知道怎么用。想问一下楼主，如果图片插入后文字环绕间距（比如图片和文字之间的边距）能通过代码调整吗？还是只能在文档里手动调？

热心网友6

非常实用的教程，感谢分享！之前一直在用python-docx处理Word文档，但发现它对图片浮动定位的支持确实比较弱，Spire.Doc这个库的API看起来直接很多，尤其是通过TextWrappingStyle和坐标属性就能实现绝对定位，省去了很多底层操作。请问在处理多张图片和大量段落时，这个库的性能怎么样？比如一次插入几百张图片会不会很慢？

热心网友6

感谢分享！这篇教程非常实用，尤其是内联和浮动图片的区分，以前总是搞不清为什么设置了坐标却不起作用，原来是要把环绕样式从嵌入型改掉。Spire.Doc 这个库确实方便，不需要装 Office 就能操作 Word，自动化排版省了很多手动调整的时间。想问一下，如果要在多个段落里分别插入不同位置的浮动图片，是不是每个段落 append 的 picture 都能独立设置坐标？还是需要额外管理坐标冲突？