如何使用python-docx修改Word表格的边框线条粗细

效果参考 #

• 表格内1pt线宽效果
• 表格内2pt线宽效果

实现逻辑 #

Word底层OpenXML规范中，表格边框线宽的计量单位为1/8磅，因此目标2pt线宽对应的XML属性值为16。python-docx没有封装全表格边框统一设置的高层接口，需要直接操作单元格对应的XML节点完成边框属性配置。

前置准备 #

先安装python-docx依赖库：

pip install python-docx

可直接运行的实现代码 #

from docx import Document
from docx.oxml import OxmlElement
from docx.oxml.ns import qn

def set_table_border_to_2pt(table):
    # 2pt 对应XML中w:sz属性值为 2*8=16
    border_width_val = "16"
    for row in table.rows:
        for cell in row.cells:
            # 获取单元格属性节点
            cell_props = cell._tc.get_or_add_tcPr()
            # 获取边框配置节点，不存在则新建
            border_node = cell_props.find(qn("w:tcBorders"))
            if border_node is None:
                border_node = OxmlElement("w:tcBorders")
                cell_props.append(border_node)
            # 依次配置单元格上、左、下、右四个方向的边框
            for edge in ("top", "left", "bottom", "right"):
                edge_node = border_node.find(qn(f"w:{edge}"))
                if edge_node is None:
                    edge_node = OxmlElement(f"w:{edge}")
                    border_node.append(edge_node)
                # 设置边框为单实线
                edge_node.set(qn("w:val"), "single")
                # 设置线宽
                edge_node.set(qn("w:sz"), border_width_val)
                # 设置边框颜色为纯黑，可按需替换为其他十六进制色值
                edge_node.set(qn("w:color"), "000000")

# 调用示例
if __name__ == "__main__":
    # 替换为你的本地文档路径
    doc = Document("target.docx")
    # 遍历文档内所有表格设置2pt线宽，若只需修改单个表格可直接索引，比如doc.tables[0]
    for tbl in doc.tables:
        set_table_border_to_2pt(tbl)
    # 保存修改后的文档
    doc.save("modified_2pt_border.docx")

补充说明 #

• 若需要设置其他线宽，只需修改border_width_val的计算逻辑即可，比如默认1pt线宽对应值为8
• 代码对合并单元格同样生效，无需额外适配
• 若需要保留部分单元格的特殊边框样式，可在遍历单元格时增加判断逻辑跳过对应单元格即可

内容的提问来源于stack exchange，提问作者logostarr