替换列名遇“Index不支持可变操作”报错，如何用df.replace或.loc解决？

原代码尝试通过遍历修改列名：

for fidx, compare in enumerate(focus_df.columns):
    for idx,c in enumerate(col_names_df['Column']):
        if compare in c:
            focus_df.columns[fidx] = col_names_df['Description'][idx]

运行时报错：

Index does not support mutable operations

核心原因 #

Pandas的DataFrame列名是Index对象，属于不可变类型，无法通过下标直接修改单个元素，这就是报错的直接原因。

关于df.replace的说明 #

df.replace是用于替换DataFrame单元格内容的工具，不支持修改列名，因此无法用它实现列名替换需求。修改列名的正确工具是df.rename()。

正确的列名替换实现 #

方法1：构建映射字典批量替换 #

先创建原列名到目标列名的映射字典，再通过rename批量替换，效率远高于嵌套循环：

# 构建列名映射字典
name_map = {}
for col in focus_df.columns:
    # 找到包含当前列名的匹配行
    match = col_names_df[col_names_df['Column'].str.contains(col)]['Description']
    if not match.empty:
        name_map[col] = match.iloc[0]

# 批量替换列名
focus_df = focus_df.rename(columns=name_map)

方法2：生成新列名列表直接赋值 #

如果不想用字典，也可以生成完整的新列名列表，直接替换整个columns属性（整体替换是允许的，仅禁止单个下标修改）：

new_cols = []
for col in focus_df.columns:
    match_row = col_names_df[col_names_df['Column'].str.contains(col)]
    if not match_row.empty:
        new_cols.append(match_row['Description'].iloc[0])
    else:
        # 无匹配时保留原列名
        new_cols.append(col)

# 替换全部列名
focus_df.columns = new_cols

关于.loc的说明 #

.loc用于定位DataFrame的行/列并修改单元格数据，无法直接修改列名本身，因此不能解决该问题。

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