### 使用 `python-docx` 设置 Word 表格的框线样式和颜色 为了设置 Word 文档中表格的边框线条，可以利用 `python-docx` 库中的特定属性。虽然该库不直接提供修改单个单元格边框样式的简便方法，但是通过操作底层 XML 可实现这一功能。 #### 导入必要的模块并初始化文档对象 首先需要导入 `Document` 类以及用于处理 XML 的辅助函数： ```python from docx import Document from docx.oxml.ns import qn from docx.oxml import OxmlElement ``` #### 创建带有指定样式的表格 创建一个新的文档实例并向其中添加一张表格： ```python doc = Document() table = doc.add_table(rows=2, cols=2) ``` #### 定义边框样式的方法 下面是一个定义边框样式的实用程序函数，此函数接受一个单元格作为参数，并为其应用所需的边框效果： ```python def set_cell_border(cell, **kwargs): """ Set cell`s border Usage: set_cell_border( cell, top={"sz": 12, "val": "single", "color": "#FF0000", "space": "0"}, bottom={"sz": 12, "color": "#00FF00", "val": "single"}, start={"sz": 24, "val": "dashed", "shadow": "true"}, end={"sz": 12, "val": "dashed"}, ) """ tc = cell._tc tcPr = tc.get_or_add_tcPr() # check for tag existnace, if none found, then create one tcBorders = tcPr.first_child_found_in("w:borders") if tcBorders is None: tcBorders = OxmlElement('w:borders') tcPr.append(tcBorders) for edge in ('start', 'top', 'end', 'bottom', 'insideH', 'insideV'): edge_data = kwargs.get(edge) if edge_data: edge_element = tcBorders.find(f"./{qn('w:' + edge)}") if edge_element is not None: tcBorders.remove(edge_element) edge_element = OxmlElement(f"w:{edge}") tcBorders.append(edge_element) for key in ["sz", "val", "color", "space", "shadow"]: if key in edge_data: edge_element.set(qn(f'w:{key}'), str(edge_data[key])) ``` 上述代码片段展示了如何向任意给定的单元格添加不同类型的边框[^3]。 #### 实际应用示例 现在可以在实际场景中调用这个函数来改变某个具体单元格的外观特性： ```python cell = table.cell(0, 0) # 获取第一个单元格 set_cell_border( cell, top={"sz": 8, "val": "single", "color": "#F79646"}, # 上方边框 bottom={"sz": 8, "val": "single", "color": "#F79646"}, # 下方边框 start={"sz": 8, "val": "single", "color": "#F79646"}, # 左侧边框 end={"sz": 8, "val": "single", "color": "#F79646"} # 右侧边框 ) ``` 最后保存文件以查看所做的更改： ```python doc.save('example.docx') ``` 这样就完成了对 Word 文档内表格边框样式的定制化配置。