### 使用 `python-docx` 修改 Word 表格边框样式的解决方案 在使用 `python-docx` 库时，可以通过设置表格单元格的 `_tcPr` 属性来实现对表格边框样式的修改。具体来说，需要操作底层 XML 来定义边框的颜色、宽度以及线条样式。 以下是详细的说明和代码示例： #### 设置表格边框的核心方法 通过访问 `table.cell(row_idx, col_idx)._element.tcPr` 可以获取到单元格的属性对象，并进一步为其添加 `<w:tcBorders>` 节点[^1]。此节点用于指定上下左右四个方向上的边框样式。 ```python from docx import Document from docx.oxml.ns import qn from docx.oxml import OxmlElement def set_cell_border(cell, border_color="000000", border_width="4"): """ 设置单元格的边框颜色和宽度。 参数: cell (TableCell): 需要设置边框的单元格对象。 border_color (str): 边框颜色，默认为黑色 ("000000")。 border_width (str): 边框粗细，默认为 "4" pt。 """ tc = cell._tc tc_pr = tc.get_or_add_tcPr() # 创建并添加边框元素 for edge in ('start', 'top', 'end', 'bottom'): border_elem = OxmlElement(f'w:{edge}') border_elem.set(qn('w:val'), 'single') border_elem.set(qn('w:color'), border_color) border_elem.set(qn('w:sz'), border_width) tc_pr.append(border_elem) # 示例：创建一个带有自定义边框的表格 doc = Document() table = doc.add_table(rows=3, cols=3) for row in table.rows: for cell in row.cells: set_cell_border(cell, border_color="FF0000", border_width="8") doc.save("example_with_borders.docx") ``` 上述代码片段展示了如何利用 `OxmlElement` 和命名空间函数 `qn()` 构建自定义边框效果[^2]。其中，`border_color` 定义了边框的颜色（十六进制 RGB 值），而 `border_width` 则控制其厚度单位为半磅（默认情况下 4 对应约 2pt）。 #### 关键注意事项 - 如果直接调用 `cell.border` 方法可能不会生效，因为该库并未完全封装所有的功能接口；因此需深入至 OpenXML 的层面手动配置。 - 不同版本间的兼容性问题可能导致某些特定参数无法正常渲染，请测试目标环境中实际表现后再部署生产环境应用。 --- ### 相关问题