使用replace函数修改dataframe名称操作失效如何解决

核心踩坑点 #

大部分场景下修改未生效都是以下3个原因导致：

• 调用了错误的方法：直接使用df.replace()只会修改DataFrame内的单元格值，不会修改列名，要修改列名需要操作columns属性，或者调用rename方法
• 没有赋值/未加inplace参数：Pandas绝大多数方法默认返回新对象，不会修改原数据，如果你只写df.columns.replace('旧名','新名')没有赋值给df.columns，修改只会保存在临时对象中，原数据列名不会变化
• 匹配规则不符：默认replace是完全匹配模式，如果你要替换列名中的部分字符，要么使用str.replace方法，要么开启regex=True参数

正确实现代码 #

1. 批量替换列名字符（部分匹配适用） #

适合需要把所有列名里的固定字符统一替换的场景：

# 替换所有列名中的"old_str"为"new_str"，regex=False代表普通字符串匹配
df.columns = df.columns.str.replace("old_str", "new_str", regex=False)

# 如果需要用正则规则匹配，把regex参数改为True
df.columns = df.columns.str.replace(r"正则匹配规则", "new_str", regex=True)

2. 指定个别列名修改 #

适合只需要修改少数几个列名的场景：

# 写法1：赋值给新对象/原对象
df = df.rename(columns={
    "旧列名1": "新列名1",
    "旧列名2": "新列名2"
})

# 写法2：加inplace参数直接修改原对象
df.rename(columns={
    "旧列名1": "新列名1",
    "旧列名2": "新列名2"
}, inplace=True)

排查步骤 #

如果修改后还是不生效，按顺序执行以下操作定位问题：

1. 执行print(df.columns.tolist())输出当前真实列名，确认你要替换的旧列名没有拼写错误、多余空格、大小写差异等问题
2. 检查你的代码是否操作的是columns属性，或者用了rename方法的columns参数，不要用df.replace()改列名
3. 确认修改后要么做了赋值操作，要么加了inplace=True参数

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