Python读取Excel文件时，如何识别被筛选的列/字段？

云原生阿岚

2026-7-20

如何用openpyxl识别Excel中被筛选的列名？

完全可以通过openpyxl实现识别Excel中被筛选的列名，下面是具体实现方案：

核心思路

openpyxl的Worksheet.auto_filter属性包含了工作表的筛选器配置，其中filterColumn字段存储了所有被应用筛选条件的列信息，我们可以通过解析这个字段，结合表头获取对应的列名。

实现代码

pip install openpyxl

from openpyxl import load_workbook
from openpyxl.utils import get_column_letter

def get_filtered_columns(file_path, sheet_name):
    wb = load_workbook(file_path, read_only=False)
    ws = wb[sheet_name]
    filtered_cols = []
    
    # 检查是否存在筛选器
    if ws.auto_filter:
        # 获取所有被筛选的列索引（从0开始）
        filtered_col_indices = ws.auto_filter.filterColumn.keys()
        # 获取表头行（假设表头在第一行）
        header_row = next(ws.iter_rows(min_row=1, max_row=1, values_only=True))
        
        for col_idx in filtered_col_indices:
            # 转换索引为列字母（openpyxl列索引从0开始，get_column_letter从1开始）
            col_letter = get_column_letter(col_idx + 1)
            # 获取对应表头的字段名
            col_name = header_row[col_idx]
            filtered_cols.append(col_name)
    
    return filtered_cols

# 调用示例
if __name__ == "__main__":
    filtered_fields = get_filtered_columns('test_filter_column.xlsx', 'data')
    print("被筛选的列名：", filtered_fields)

代码说明

ws.auto_filter.filterColumn：返回一个字典，键是列的索引（从0开始），值为该列的筛选配置对象，只要存在键的列就是被应用了筛选的列。
get_column_letter：将列索引（从0开始）转换为Excel的列字母（如0→A），方便对应列位置。
默认假设表头位于工作表的第一行，如果你的表头在其他行，只需调整iter_rows的min_row和max_row参数即可。