Python openpyxl：单个Excel工作表多NamedStyle使用报错问题

首先，咱们先拆解你遇到的两个核心问题：一是报错提示样式已存在，二是样式应用的代码逻辑有误。下面一步步帮你修复：

1. 解决重复添加命名样式的报错 #

你看到的ValueError: Style TableHeaderStyle exists already，是因为每次运行代码时都会尝试往工作簿里添加同名样式，而openpyxl不允许重复注册相同名称的命名样式。解决办法是添加前先检查样式是否已存在：

# 检查并添加表头样式，不存在才添加
if "TableHeaderStyle" not in book.named_styles:
    book.add_named_style(tableHeaderStyle)
# 检查并添加普通边框样式
if "NormalBorderStyle" not in book.named_styles:
    book.add_named_style(normalBorderStyle)

2. 修正样式应用的逻辑错误 #

你的set_border函数里有个关键错误：cell.border = "TableHeaderStyle"是无效代码——border属性需要的是Border对象，不是样式名称。正确的做法是直接给cell.style赋值对应的命名样式，同时准确识别表头行：

def set_border(ws, cell_range):
    # 获取单元格范围的起始行，用来判断是否为表头行
    start_row = ws[cell_range][0][0].row
    for row in ws.iter_rows(cell_range):
        for cell in row:
            if cell.row == start_row:
                # 表头行应用表头样式（加粗+背景+边框）
                cell.style = "TableHeaderStyle"
            else:
                # 数据行仅应用边框样式
                cell.style = "NormalBorderStyle"

3. 完整修正后的代码 #

把上述修改整合后，最终代码如下（还优化了一些弃用的API调用）：

from openpyxl.styles import Border, Side, Color, PatternFill, Font, Alignment, NamedStyle
from openpyxl import load_workbook

# 定义通用边框
my_border = Border(
    left=Side(border_style='thin', color='000000'),
    right=Side(border_style='thin', color='000000'),
    top=Side(border_style='thin', color='000000'),
    bottom=Side(border_style='thin', color='000000')
)

# 定义命名样式
normalBorderStyle = NamedStyle(
    name="NormalBorderStyle",
    alignment=Alignment(horizontal='center', vertical='center', wrap_text=True),
    border=my_border
)

tableHeaderStyle = NamedStyle(
    name="TableHeaderStyle",
    alignment=Alignment(horizontal='center', vertical='center'),
    border=my_border,
    font=Font(bold=True),
    fill=PatternFill(patternType='solid', fill_type='solid', fgColor=Color('C4D79B'))
)

# 修正后的样式设置函数
def set_border(ws, cell_range):
    start_row = ws[cell_range][0][0].row
    for row in ws.iter_rows(cell_range):
        for cell in row:
            if cell.row == start_row:
                cell.style = "TableHeaderStyle"
            else:
                cell.style = "NormalBorderStyle"

# 加载并处理工作簿
xlsfile = "your_file_path.xlsx"  # 替换为你的Excel文件路径
book = load_workbook(xlsfile)

# 安全添加命名样式
if "TableHeaderStyle" not in book.named_styles:
    book.add_named_style(tableHeaderStyle)
if "NormalBorderStyle" not in book.named_styles:
    book.add_named_style(normalBorderStyle)

# 获取工作表（替换了已弃用的get_sheet_by_name）
ws_active = book["Summary"]
# 应用样式到指定单元格范围
set_border(ws_active, "B3:G7")

# 务必保存修改
book.save(xlsfile)

额外提示 #

• 我把get_sheet_by_name换成了book["Summary"]，因为前者已经被openpyxl官方弃用，索引方式更规范。
• 最后一定要调用book.save()，否则所有样式修改都不会写入到文件中。

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