### 如何使用 `python-docx` 库设置表格边框样式 通过 `python-docx` 库可以方便地创建 Word 文档并添加带样式的表格。虽然该库本身不直接提供设置整个表格边框的功能，但可以通过操作单元格来实现这一目标。 以下是详细的说明以及代码示例： #### 使用 `set_cell_border` 函数自定义单元格边框 为了简化对多个单元格的操作，通常会编写一个辅助函数 `set_cell_border` 来统一管理单元格的边框属性。此函数允许单独配置顶部、底部、左侧、右侧以及其他内部边框的样式[^1]。 ```python from docx import Document from docx.oxml.ns import qn from docx.oxml import OxmlElement def set_cell_border(cell, **kwargs): """ 设置单元格的边框样式。 参数: cell (Cell): 要修改的单元格对象。 kwargs: 边框的具体参数，支持 top, bottom, left, right 和 insideV/insideH。 每个参数是一个字典，包含 sz(大小), val(样式), color(颜色) 等键值。 """ tc = cell._tc tcPr = tc.get_or_add_tcPr() # 清除已有边框 for child in tcPr: if child.tag.endswith('tcBorders'): tcPr.remove(child) borders_xml = ''' <w:tcBorders xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"> {top} {bottom} {left} {right} {insideH} {insideV} </w:tcBorders> ''' def add_border(name, attr_dict=None): xml = f'<w:{name} w:sz="{attr_dict["sz"]}" w:val="{attr_dict["val"]}" w:color="{attr_dict["color"]}" />' return xml if attr_dict is not None else '' attrs = { 'top': kwargs.get('top', None), 'bottom': kwargs.get('bottom', None), 'left': kwargs.get('left', None), 'right': kwargs.get('right', None), 'insideH': kwargs.get('insideH', None), 'insideV': kwargs.get('insideV', None) } border_str = ''.join([add_border(key, value) for key, value in attrs.items()]) .tcPr.append(OxmlElement(borders_xml.format(**attrs))) ``` #### 创建带有边框的表格 下面展示了一个完整的例子，演示如何利用上述方法生成具有特定边框样式的表格，并将其保存至指定路径。 ```python document = Document() # 添加表格 table = document.add_table(rows=3, cols=3) # 定义默认边框样式 default_border_style = {"sz": "6", "val": "single", "color": "#000000"} for row in table.rows: for cell in row.cells: set_cell_border( cell, top=default_border_style, bottom=default_border_style, left=default_border_style, right=default_border_style ) # 保存文件 document.save(r"C:\Users\Administrator\Desktop\demo_with_borders.docx") ``` 以上脚本实现了为每个单元格应用相同的黑色实线边框效果[^2]。 #### 自定义不同类型的边框 如果希望某些区域采用不同的边框风格，则只需调整传递给 `set_cell_border` 的参数即可。例如，让表头更突出一些： ```python header_cells = table.rows[0].cells for cell in header_cells: set_cell_border( cell, top={"sz": "12", "val": "double", "color": "#FF0000"}, bottom=default_border_style, left=default_border_style, right=default_border_style ) ``` 这样就完成了头部与其他部分区分开来的视觉设计。 ---