You need to enable JavaScript to run this app. 如何用Python获取并修改docx文档内形状的颜色、宽度、高度等属性
优惠活动
大模型
产品
解决方案
定价
更多

如何用Python获取并修改docx文档内形状的颜色、宽度、高度等属性

可实现需求的Python落地方案

python-docx原生仅封装了文档内文本段落、表格、嵌入图片等结构化内容的操作能力,对绘图层的自选形状(矩形、自绘图形等)无对应高层API,这也是查阅官方文档找不到相关功能说明的核心原因。

方案1:基于python-docx + lxml 操作底层OpenXML节点(跨平台可用)

docx本质是符合OpenXML标准的ZIP压缩包,所有形状的属性都以XML节点形式存储在文档结构中,可以绕过python-docx的高层封装,直接操作对应节点实现属性修改:

  • 核心逻辑:python-docx读入文档后,可通过每个文档元素的._element属性拿到底层XML节点,结合lxml完成形状节点的遍历、属性修改,最后直接保存文档即可,无需手动解压、重新打包压缩包
  • 可直接修改的属性对应节点位置:
    • 形状宽高:定位到形状节点下的<a:ext>标签,其cx(宽度)、cy(高度)属性使用EMU作为计量单位,直接修改属性值即可调整尺寸
    • 形状填充颜色:定位到形状下<a:solidFill>内的<a:srgbClr>节点,修改其val属性为十六进制颜色值(如2F5496对应标准深蓝)即可
    • 形状轮廓宽度:定位到形状下的<a:ln>标签,修改其w属性值即可调整边框粗细,单位同样为EMU
  • 参考实现代码:
from docx import Document
from lxml import etree

# 定义DrawingML相关命名空间,避免节点匹配失败
ns = {
    'w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
    'a': 'http://schemas.openxmlformats.org/drawingml/2006/main'
}

doc = Document("目标文档.docx")
# 遍历文档内所有嵌入的图形对象
for drawing in doc.element.iter(f"{{{ns['w']}}}drawing"):
    # 匹配基础形状节点,<a:sp>对应所有矩形、自选图形类对象
    shape = drawing.find(f".//{{{ns['a']}}}sp")
    if shape is not None:
        # 换算规则:1厘米=360000EMU,此处将形状宽度改为5厘米
        ext = shape.find(f".//{{{ns['a']}}}ext")
        ext.set("cx", str(5 * 360000))
        # 将形状高度改为3厘米
        ext.set("cy", str(3 * 360000))
        # 将形状填充改为正红色
        srgb = shape.find(f".//{{{ns['a']}}}solidFill/{{{ns['a']}}}srgbClr")
        srgb.set("val", "FF0000")
        # 换算规则:1磅=12700EMU,此处将轮廓宽度改为2磅
        ln = shape.find(f".//{{{ns['a']}}}ln")
        ln.set("w", str(2 * 12700))

doc.save("修改后的文档.docx")

方案2:基于win32com 调用本地Word程序(仅Windows平台可用)

如果运行环境为Windows且已安装Microsoft Office,可通过pywin32库调用Word原生COM接口完成操作:

  • 该方式无需手动解析XML节点,Word原生Shape对象直接暴露Width、Height、Fill.ForeColor.RGB、Line.Weight等可修改属性,能覆盖所有Word支持的形状操作场景
  • 局限性:无法跨平台运行,对运行环境有强依赖

实操注意事项

  • 操作XML节点时必须匹配正确的DrawingML命名空间,否则会出现节点查找不到、属性修改不生效的问题
  • 图形尺寸、轮廓粗细属性的基础计量单位是EMU,不要直接传入厘米、磅值这类常见单位,避免换算错误导致文档打开异常
  • python-docx的形状操作能力属于长期待排期的功能项,短期内不会在官方稳定版中提供对应封装

内容的提问来源于stack exchange,提问作者Martin Gergov

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.23 18:27:04