如何在Python Pandas中批量修改列名或索引标签?

千晨同学_8103

千晨同学_8103

2026-06-05

362人浏览

原创

推荐用 rename() 批量改列名:安全(只改存在的键)、灵活(支持字典映射和函数式重命名,如加前缀或转小写),并兼容索引、multiindex;set_axis() 适用于全量覆盖且长度严格匹配的场景。

如何在python pandas中批量修改列名或索引标签?

用 rename() 批量改列名,别直接赋值 columns

直接写 df.columns = ["a", "b", "c"] 看似快,但容易出错:列数不匹配时会报 ValueError: Length mismatch,且无法按条件筛选重命名(比如只改含"price"的列)。rename() 更安全、更灵活。

推荐用字典映射:df.rename(columns={"old1": "new1", "old2": "new2"})。它只改存在的键,缺失键被忽略,不报错;也支持函数式重命名,比如统一加前缀:df.rename(columns=lambda x: f"col_{x}")。

  • 注意:默认返回新 DataFrame,原地修改要加 inplace=True(但建议链式调用,少用 inplace)
  • 若列名含空格或特殊字符,字典键必须严格匹配原始字符串(区分大小写、空格)
  • 重命名后若需验证,可检查 df.columns.tolist(),别只看 print(df) —— Jupyter 有时显示截断

重命名索引标签用 rename() 的 index 参数

和列名一样,索引标签也能批量改,只是参数名换成 index:df.rename(index={0: "row_a", 1: "row_b"})。常见场景是把数字索引替换成业务 ID,或修复读取 CSV 时误把首行当列名导致的脏索引。

函数式用法同样有效,比如把所有索引转小写:df.rename(index=str.lower);或者用 range 重置为连续整数(但这时更适合用 reset_index(drop=True))。

Pandas Linux版 2.3.3
Pandas Linux版 2.3.3

Pandas 2.3.3 历史版本下载,来自 PyPI 官方发布,适合旧项目兼容、数据分析脚本复现和指定环境安装。

下载
  • 如果索引是 DatetimeIndex,rename(index=...) 不起作用——它只对 label 生效,不对时间戳本身做转换
  • 想批量替换索引中某段子串?先转成列表处理再赋回:df.index = df.index.astype(str).str.replace("OLD", "NEW")
  • rename() 对 MultiIndex 也支持,但字典键必须是元组,例如 {("A", "X"): ("B", "Y")}

用 set_axis() 替换整套列名或索引,适合“全量覆盖”场景

当你确定要完全替换全部列名(不保留任何旧名),set_axis() 比 rename() 更直白:df.set_axis(["a", "b", "c"], axis=1)(axis=1 表示列);axis=0 则对应索引。

它的优势是语义清晰、不依赖旧名匹配,适合从外部配置读取新列名列表的场景(如对接不同数据源的字段映射表)。但风险也明显:长度必须严格一致,否则抛 ValueError: Length mismatch。

  • 它不接受字典或函数,只接受 list/tuple/Index 类型
  • 如果新名称里有重复值,Pandas 不报错,但后续按标签选取(如 df["col"])会出问题——务必提前去重
  • 和 rename() 一样,默认返回新对象;若配合 copy=False,在某些视图场景下可能触发 SettingWithCopyWarning,慎用

别忽略链式操作中的重命名时机

在 groupby().agg() 或 pd.concat() 后,列名常被自动改造(比如变成多级索引或带聚合函数后缀),这时再用 rename(columns=...) 可能失效——因为目标列名已不是字符串,而是元组或 frozenset。

典型例子:df.groupby("cat").sum().rename(columns={"val": "total"}) 在单列聚合时有效,但多列时列名是元组,得写成 {("val", "sum"): ("total", "sum")},或者先用 droplevel() 扁平化。

  • 不确定当前列类型?查 type(df.columns) —— 是 Index 还是 MultiIndex
  • 用 df.columns.map(str) 强制转字符串再 rename,适用于简单扁平化,但会丢失结构信息
  • 最稳妥的做法:在链式操作早期就固定列名,比如读取后立刻 rename(),避免后期“猜”列名格式

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1651

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4044

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1649

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

23297

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2867

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2887

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1143

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2243

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Pandas 官方文档与用户指南
Pandas 官方文档与用户指南

共0课时 | 0人学习

Pandas 教程
Pandas 教程

共15课时 | 1.9万人学习