使用Pandas与XlsxWriter实现Excel表格筛选时添加表格样式报错求助

报错原因 #

你遇到的错误是因为XlsxWriter不允许在同一单元格区域同时设置普通autofilter和Excel表格（Table）——Excel表格本身自带筛选功能，重复定义会触发格式冲突。

解决方案 #

直接用add_table()创建带样式的表格，同时保留筛选和行隐藏逻辑，步骤如下：

1. 移除原代码里的autofilter()、filter_column()调用和手动隐藏行的循环
2. 先创建带样式的表格（自带筛选功能）
3. 重新添加行隐藏逻辑

修正后的完整代码 #

import xlsxwriter
import pandas as pd

df = pd.DataFrame({'Region' : ['East', 'West', 'South', 'North'],
                   'Item' : ['Pear', 'Grape', 'Peach', 'March'],
                   'Volume' : [9000, 8000, 7000, 6000],
                   'Month' : ['July', 'March', 'April', 'June']})

writer = pd.ExcelWriter('filter_Test.xlsx', engine = 'xlsxwriter')
df.to_excel(writer, sheet_name='Sheet1', index=False)

workbook  = writer.book
worksheet = writer.sheets['Sheet1']
(max_row, max_col) = df.shape
worksheet.set_column(0,  max_col - 1, 12)

# 创建带样式的表格，自带筛选功能
column_settings = [{'header': column} for column in df.columns]
worksheet.add_table(0, 0, max_row, max_col - 1, {
    'columns': column_settings,
    'style': 'table_style_light_1'  # 可选，设置Excel自带的表格样式
})

# 隐藏非March的行，逻辑和原代码一致
for row_num in df.index[(df['Month'] != 'March')].tolist():
    worksheet.set_row(row_num + 1, options={'hidden': True})

writer.close()

补充说明 #

• 表格创建后会自动在表头添加筛选按钮，和原autofilter效果完全一致
• style参数可指定Excel自带的各类表格样式，比如table_style_medium_2、table_style_dark_1等，对应Excel界面里的表格样式选项
• 行隐藏逻辑放在表格创建后执行，既避免冲突，又能保留筛选后的隐藏效果

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