pandas rename方法重命名列时value列未生效问题排查

根本原因 #

rename方法语法无错误，date列重命名成功可验证这点。value列重命名失败的核心原因是传入的映射key'value'与DataFrame中对应列的真实列名不完全匹配，最常见的诱因是列名夹带不可见字符：包括列名前后的空格、制表符\t、换行符\n，或是导入数据时混入的特殊不可见字符，少数情况是列名存在大小写差异。

排查步骤 #

执行以下代码打印列名的原始表示，可直接暴露所有不可见字符：

print([repr(col) for col in new_df2.columns])

执行后可看到第二列的真实列名并非纯字符串'value'，多为'value '（尾部带空格）、' value'（头部带空格）这类带隐藏空白的形式。

解决方案 #

• 精准匹配重命名：将rename字典中value对应的键替换为排查得到的真实列名即可，例如排查到真实列名为尾部带空格的'value '时，代码修改为：

  new_df2 = new_df2.rename(columns={
      'value ': 'Euro to Dollar rate',
      'date':'exchange rate date'
  })
  

• 按列位置直接赋值：如果列顺序固定、总列数较少，可直接给columns属性传入新列名列表，跳过列名匹配环节：

  new_df2.columns = ['exchange rate date', 'Euro to Dollar rate']
  

• 预处理列名后重命名：如果是批量导入的数据源经常夹带多余空白，可先统一清理所有列名的前后空白，再执行原有重命名逻辑，从根源避免匹配问题：

  # 批量去除所有列名前后的空白字符
  new_df2.columns = new_df2.columns.str.strip()
  # 执行原重命名逻辑
  new_df2 = new_df2.rename(columns={'value': 'Euro to Dollar rate','date':'exchange rate date'})
  

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