使用openpyxl循环清除Excel边框时出现不一致结果的问题排查

我在使用Excel模板导出数据时，遇到了边框清除结果不一致的问题：部分单元格显示“无格式”或默认边框，另一部分单元格的边框却显示为白色。

相关代码如下：

side_none = Side(border_style=None, color=None)
side = Side(border_style="thin", color="FF000000")
borders_none = Border(left=side_none, right=side_none, top=side_none, bottom=side_none)
borders = Border(left=side, right=side, top=side, bottom=side)

# 清除模板默认边框并在指定区域应用新边框
apply_cell_borders(ws, "A2:J37", borders_none)  # 此部分效果异常
apply_cell_borders(ws, "A2:J" + str(row_cell - 1), borders)  # 此部分正常

def apply_cell_borders(worksheet, cell_range, border_style):
    for row in worksheet[cell_range]:
        for cell in row:
            cell.border = border_style

问题原因 #

在openpyxl中，使用border_style=None清除边框时，并不会完全覆盖模板单元格的原有边框样式。None表示不设置该边框属性，单元格会继承模板的预设样式（比如白色边框），而非真正清除所有边框，这就导致了结果不一致。

解决方法 #

方法1：使用border_style="none"替代border_style=None #

openpyxl中明确指定无边框的正确方式是设置border_style="none"，而非None。修改后的代码如下：

# 修正Side的border_style参数
side_none = Side(border_style="none", color=None)
borders_none = Border(left=side_none, right=side_none, top=side_none, bottom=side_none)

side = Side(border_style="thin", color="FF000000")
borders = Border(left=side, right=side, top=side, bottom=side)

# 保留原有的边框应用函数
def apply_cell_borders(worksheet, cell_range, border_style):
    for row in worksheet[cell_range]:
        for cell in row:
            cell.border = border_style

# 调用逻辑不变
apply_cell_borders(ws, "A2:J37", borders_none)
apply_cell_borders(ws, "A2:J" + str(row_cell - 1), borders)

方法2：重置单元格样式（针对模板有样式继承的场景） #

如果模板单元格应用了自定义样式，仅修改边框可能无法覆盖原有设置，此时需要先将单元格样式重置为默认，再设置边框：

def apply_cell_borders(worksheet, cell_range, border_style):
    for row in worksheet[cell_range]:
        for cell in row:
            # 重置为默认样式，避免继承模板的自定义样式
            cell.style = 'Normal'
            cell.border = border_style

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