如何在Python docx中修改表格边框颜色？

核心思路 #

python-docx中，表格的外部边框与内部单元格边框，均可通过设置对应边框对象的color属性修改颜色，同时可按需调整边框宽度。

代码示例 #

1. 导入所需模块

from docx import Document
from docx.shared import Pt
from docx.dml.color import RGBColor

2. 打开文档并获取目标表格

假设你的报表文件名为report.docx，要修改第1个表格（索引从0开始）：

doc = Document("report.docx")
table = doc.tables[0]  # 若要修改多个表格，直接遍历doc.tables即可

3. 修改表格边框颜色

方式一：统一设置所有边框颜色

# 设置表格外部边框（上下左右）
for border in (table.top_border, table.bottom_border, table.left_border, table.right_border):
    border.color = RGBColor(0, 128, 0)  # 绿色，RGB值可自行替换
    border.width = Pt(1)  # 可选：设置边框粗细，单位为磅

# 设置内部单元格边框（横向+纵向）
for row in table.rows:
    for cell in row.cells:
        for border in (cell.top_border, cell.bottom_border, cell.left_border, cell.right_border):
            border.color = RGBColor(0, 128, 0)
            border.width = Pt(1)

方式二：区分设置内外边框颜色

# 外部边框设为深黑色
for border in (table.top_border, table.bottom_border, table.left_border, table.right_border):
    border.color = RGBColor(0, 0, 0)
    border.width = Pt(1.5)

# 内部边框设为浅灰色
for row in table.rows:
    for cell in row.cells:
        for border in (cell.top_border, cell.bottom_border, cell.left_border, cell.right_border):
            border.color = RGBColor(200, 200, 200)
            border.width = Pt(0.5)

4. 保存修改后的文档

doc.save("modified_report.docx")

注意事项 #

• RGB颜色值范围为0-255，可按需调整（比如红色是RGBColor(255,0,0)，蓝色是RGBColor(0,0,255)）。
• 若需批量修改多个表格，直接循环for table in doc.tables:即可复用代码。
• 确保python-docx为最新版本，可通过pip install python-docx --upgrade更新。

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