最常见原因是未设 inplace=True 或字典键与列名不完全匹配；rename() 默认返回新 DataFrame，键需严格一致（含大小写、空格），MultiIndex 需特殊处理；函数式 rename(columns=lambda x: x.replace('id','ID')) 支持批量替换。
pd.DataFrame.rename() 字典映射改列名为什么没生效？
最常见原因是直接调用 rename() 没加 inplace=True，或者传入的字典键根本不在原列名里——pandas 默认只改匹配上的列，不报错也不提示缺失键。
- 默认返回新 DataFrame，原数据不变；要就地修改必须显式写
inplace=True - 字典键必须和
df.columns中的字符串完全一致（区分大小写、空格、不可见字符） - 如果列名是
MultiIndex，普通字典映射无效，得用levels+codes或专门方法 - 示例：
df.rename(columns={'old_name': 'new_name'}, inplace=True)
rename(columns=...) 和 columns = [...] 两种改法区别在哪？
前者是按名映射，安全可控；后者是按位置批量覆盖，快但危险——顺序错一点，整列语义就全乱了。
-
rename()只改字典里列出的列，其余列名保持不变；columns = [...]会强制重置全部列名，长度不匹配直接报ValueError: Length mismatch - 当只改个别列时，
rename()更可维护；当需要彻底重命名+调整顺序，用columns = [...]更直接 - 性能上，
columns = [...]是 O(1) 赋值；rename()需遍历列名做键查找，但对万级以下列数差异可忽略
中文列名或含空格列名用 rename() 报 KeyError 怎么办？
不是 rename 的问题，是你的字典键里写了看不见的空格、全角字符，或者用了变量名误当字符串。
- 先打印
list(df.columns)看真实列名，别凭感觉写键名 - 避免写成
{my_var: 'new'}（把变量值当键），应写成{'my_var': 'new'}（字符串字面量） - 中文列名没问题，但复制粘贴时容易混入全角空格或零宽字符，建议手动敲一遍键名
- 可用
df.columns.str.strip()预处理列名再 rename，防空格干扰
想批量替换列名中的某段文字，比如把所有 'id' 改成 'ID'，能用 rename 吗？
不能直接用字典映射，但可以用 rename(columns=lambda x: x.replace('id', 'ID')) —— 这里传的是函数，不是字典。
立即学习“Python免费学习笔记（深入）”；
- 字典映射只支持精确匹配；函数方式支持任意字符串处理逻辑
- 注意
replace()是全局替换，如列名 'user_id' → 'user_ID'，'admin_id_card' → 'admin_ID_card'，需确认是否符合预期 - 更稳妥的做法：先生成映射字典
{col: col.replace('id', 'ID') for col in df.columns if 'id' in col}，再传给rename(columns=...) - 函数方式无法跳过不匹配的列，所有列都会被处理；字典方式只影响存在的键
print(repr(list(df.columns)))，比猜十次都管用。 
