### 如何在 `python-docx` 中设置表格边框粗细 在 Python 的 `python-docx` 库中，虽然提供了丰富的功能用于操作 Word 文档中的文字、段落和表格等内容，但对于更复杂的样式控制（如表格边框的粗细），需要通过底层 XML 属性进行自定义配置[^2]。 以下是具体方法以及示例代码： #### 使用 `python-docx` 自定义表格边框粗细 可以通过修改 `_tblPr` 和 `_tcPr` 对象来调整单元格级别的边框属性。下面是一个完整的实现方式： ```python from docx import Document from docx.shared import Pt from docx.oxml.ns import qn from docx.oxml import OxmlElement def set_cell_border(cell, border_color="auto", border_width="12700"): """ 设置单元格的边框颜色和宽度。 参数: cell (Cell): 表格单元格对象。 border_color (str): 边框的颜色，默认为自动。 border_width (str): 边框的宽度，默认为 12700 即标准线宽。 """ tc = cell._tc tcPr = tc.get_or_add_tcPr() # 清除已有边框 for lines in ['a:lnL', 'a:lnR', 'a:lnT', 'a:lnB']: ln = tcPr.xpath(f"./w:{lines}")[0] if len(tcPr.xpath(f"./w:{lines}")) > 0 else None if ln is not None: tcPr.remove(ln) # 添加新的边框 for edge in ('start', 'end', 'top', 'bottom'): ln = OxmlElement('w:tcBorders') ln.set(qn('w:val'), str(edge)) ln_s = OxmlElement('w:' + edge) ln_s.set(qn('w:color'), border_color) ln_s.set(qn('w:sz'), border_width) ln_s.set(qn('w:space'), "0") ln_s.set(qn('w:cap'), "flat") ln.append(ln_s) tcPr.append(ln) # 创建文档并添加表格 doc = Document() table = doc.add_table(rows=3, cols=3) for row in table.rows: for cell in row.cells: cell.text = "测试" set_cell_border(cell, border_color="FF0000", border_width="25400") # 红色加粗边框 doc.save("example.docx") ``` 上述代码实现了对每个单元格单独设定边框的功能，并允许指定不同的颜色和厚度。 #### 关键点解析 - **OxmlElement**: 这是 `python-docx` 提供的一个工具类，可以用来直接操作 OpenXML 元素树结构。 - **qn 函数**: 定义命名空间前缀映射关系以便于生成合法的 XML 标签名称。 - **border_width**: 控制线条的实际显示大小，单位为 EMU（English Metric Unit）。默认情况下，“12700”表示正常线宽；而 “25400” 则代表两倍于此的标准加粗效果[^2]。 ---