Python使用DataFrame读取CSV文件无法识别列名报KeyError如何解决

这种拼写肉眼一致但报KeyError的问题，几乎都是第三方生成的CSV列名包含肉眼不可见的特殊字符导致的，常见原因包括：

• 列名前后存在多余的半角/全角空格、制表符、换行符
• UTF-8带BOM编码的CSV，第一列列名开头会隐含\ufeff字符
• 列名包含相似字形的不同编码字符，比如西里尔字母和英文字母、全角英文字符和半角英文字符

第一步：先确认实际读取到的列名 #

执行代码打印完整列名列表，即可看到隐藏的特殊字符：
print(df.columns.tolist())

第二步：通用列名清理方案 #

读入CSV后批量清理所有列名的异常字符，不需要手动修改原CSV文件：

import pandas as pd

# 读入时指定utf-8-sig编码自动处理BOM头问题
df = pd.read_csv("第三方文件.csv", encoding="utf-8-sig")

# 批量清理列名：先去除首尾所有空白字符
df.columns = df.columns.str.strip()
# 可选深度清理：移除所有非字母/数字/下划线的字符，连续空格/特殊符号替换为单个下划线
df.columns = df.columns.str.replace(r"[^\w]", "_", regex=True).str.replace(r"_+", "_", regex=True).str.strip("_")

第三步：临时适配方案 #

如果不想全局修改列名，也可以通过模糊匹配找到目标列的真实名称：

expected_col = "你要查找的列名"
real_col = None
for col in df.columns:
    # 忽略大小写和首尾空白匹配
    if col.strip().lower() == expected_col.strip().lower():
        real_col = col
        break

if real_col:
    # 用匹配到的真实列名调用即可
    print(df[real_col])
else:
    print("未找到目标列，请核对文件列名")

内容的提问来源于stack exchange，提问作者Gauthier C.