pandas筛选Excel列报'list' object has no attribute 'str'错如何解决

报错的核心原因是代码里的[columnSelect]是Python原生列表对象，只有pandas的Series（DataFrame的单列数据结构）才支持.str开头的字符串处理方法，原生列表没有这个属性，所以直接抛出AttributeError。
原代码还存在几个其他问题：

• 定义filterFunction()后所有功能代码没有缩进，函数实际是空的，后续代码全是全局游离代码
• pd.read_excel传入sheet_name=['Treatment Settings']时会返回以表名为key的字典，虽然取df['Treatment Settings']能拿到对应表，但单表读取时直接传表名字符串更简洁
• 写的df.values()是错误用法：values是DataFrame的属性不是可调用方法，且这行对功能没有任何作用
• .loc的第一个参数需要传入行筛选的布尔掩码，原代码逻辑没有先取到对应列的Series，无法生成正确的筛选掩码

import pandas as pd
import os

def filterFunction():
    # 列出当前目录下所有xlsx格式文件
    fileList = [f for f in os.listdir() if f.endswith('.xlsx')]
    print("当前目录下Excel文件列表：")
    for f in fileList:
        print(f"- {f}")
    chooseFile = input("请输入要读取的.xlsx文件名：")
    # 读取指定工作表
    df = pd.read_excel(chooseFile, sheet_name='Treatment Settings')

    # 获取用户筛选条件
    columnSelect = input("请输入要搜索的列名：")
    # 基础校验：判断列是否存在
    if columnSelect not in df.columns:
        print(f"输入错误，当前表不存在名为{columnSelect}的列，现有列名：{list(df.columns)}")
        return
    substringSelect = input("请输入要搜索的文本：")

    # 生成筛选掩码：取指定列做不区分大小写的文本匹配，空值按不匹配处理
    filter_mask = df[columnSelect].str.contains(substringSelect, case=False, na=False)
    # 传入loc筛选符合条件的行
    gatherSubstring = df.loc[filter_mask]

    # 打印结果
    print(f'\n------列"{columnSelect}"包含文本"{substringSelect}"的筛选结果------\n')
    print(gatherSubstring)

if __name__ == "__main__":
    filterFunction()

• 修正核心报错：将原代码中包裹列名的原生列表[columnSelect]改为df[columnSelect]，拿到对应列的Series对象后再调用.str.contains()生成筛选掩码
• 修正函数结构：将所有业务逻辑缩进放入filterFunction函数体，增加主入口调用，避免函数空转
• 删除无效的df.values()代码
• 增加基础的列名校验逻辑，避免用户输错列名直接触发异常
• 优化文件列表展示，仅显示xlsx格式文件，减少用户选错文件的概率

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