在 `python-docx` 中，`add_picture()` 方法用于向文档中插入图片，但该方法本身并不直接支持为图片添加边框。要实现为图片添加边框的功能，需要操作底层的 XML 结构，通过修改图片的图形属性来实现边框效果[^1]。 ### 实现方式 `python-docx` 中的图片对象基于 Office Open XML (OOXML) 格式构建，其样式和属性由底层 XML 元素控制。为图片添加边框需要修改其图形属性（`<pic:spPr>` 节点），设置边框线条的样式、颜色和宽度。 以下是一个为插入的图片添加边框的示例代码： ```python from docx import Document from docx.oxml import OxmlElement from docx.oxml.ns import qn def add_border_to_picture(picture): # 获取图片的 XML 元素 pic = picture._inline.graphic.graphicData.pic sp_pr = pic.spPr # 获取图形属性节点 # 如果图形属性节点不存在，则创建 if sp_pr is None: sp_pr = OxmlElement('pic:spPr') pic.insert(pic.index(pic.nvPicPr) + 1, sp_pr) # 创建边框节点 ln = OxmlElement('a:ln') ln.set(qn('w'), '12700') # 边框宽度，单位为 EMU（1pt = 12700 EMU） ln.set(qn('cap'), 'flat') ln.set(qn('cmpd'), 'sng') ln.set(qn('algn'), 'ctr') # 设置边框颜色 solid_fill = OxmlElement('a:solidFill') srgb_clr = OxmlElement('a:srgbClr') srgb_clr.set(qn('val'), '000000') # 黑色边框 solid_fill.append(srgb_clr) ln.append(solid_fill) # 设置边框线型 prst_dash = OxmlElement('a:prstDash') prst_dash.set(qn('val'), 'solid') ln.append(prst_dash) # 将边框属性添加到图形属性中 sp_pr.append(ln) ``` 使用方式如下： ```python doc = Document() paragraph = doc.add_paragraph() run = paragraph.add_run() picture = run.add_picture('example.jpg') add_border_to_picture(picture) doc.save('document_with_picture_border.docx') ``` ### 边框参数说明 - **边框宽度**：通过 `w` 属性设置，单位为 EMU（1pt = 12700 EMU）。 - **边框颜色**：通过 `a:srgbClr` 设置十六进制颜色值，如 `000000` 表示黑色。 - **线型**：`prstDash` 可设置为 `solid`（实线）、`dot`（点线）、`dash`（虚线）等。 ### 注意事项 - `python-docx` 对图片样式的控制较为有限，需通过操作底层 XML 实现高级样式设置。 - 修改 XML 结构时应确保节点层级正确，否则可能导致文档损坏或运行时异常。 - 边框设置可能在不同版本的 Word 中显示效果略有差异。 ###