Python中MultiIndex类型DataFrame执行rename重命名列无效问题

1. 为什么映射不存在的键不会报错 #

pandas的DataFrame.rename()方法默认参数为errors='ignore'，对于映射字典中不存在的原名称会直接跳过处理，不会抛出异常，属于官方设计的正常行为。如果需要匹配失败时报错，可以显式指定参数errors='raise'。

2. 为什么重命名不生效 #

核心原因是你写的原列名元组('mkt_val','PORT')没有命中实际的列名，最常见的两种场景如下：

• 场景1：对列结构判断错误
  你给出的示例表中，cusip大概率是行索引而非列的第一层级，你看到的PORT可能是行索引名称或第一行数据，实际列只有单级mkt_val，并非你以为的两级MultiIndex结构。
  可以先执行print(df.columns)打印真实的列结构验证，如果输出为Index(['mkt_val'], dtype='object')即可确认是该问题。
• 场景2：MultiIndex层级顺序写反
  如果确认列确实是两级MultiIndex，很可能是层级顺序和你写的元组顺序相反，实际列名元组为('PORT', 'mkt_val')，顺序不匹配自然无法命中重命名规则。

解决方法 #

先执行print(df.columns)确认真实列结构后再对应修改：

• 如果是单级列，直接写：

df.rename(columns={'mkt_val': 'market_val'}, inplace=True)

• 如果确认是两级MultiIndex且元组正确，可加上报错参数避免静默失败：

df.rename(columns={('mkt_val', 'PORT'): 'market_val'}, errors='raise', inplace=True)

• 如果需要直接将MultiIndex列改为单级，也可以直接赋值修改：

df.columns = ['market_val']

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