最直接方法是df['info'].apply(pd.series),但需先检查数据类型、处理空值和键不一致,推荐用pd.json_normalize()提升性能,或用map()按需提取关键字段。

用 apply(pd.Series) 展开字典列最直接,但要注意空值和键不一致
当 DataFrame 某一列(比如 'info')存的是字典,想把每个 key 变成独立列,df['info'].apply(pd.Series) 是最常用也最轻量的解法。它会自动对齐所有字典的 key,缺失的填 NaN。
常见错误是直接 apply 后没处理空值或结构不齐——比如有的字典是 {'a': 1, 'b': 2},有的却是 {'a': 1, 'c': 3},甚至还有 None 或空字典。这时 pd.Series 仍能运行,但结果里会出现大量 NaN,且列名混合了所有出现过的 key(包括你没预料到的),后续 merge 容易出错。
- 务必先检查
df['info'].apply(type).unique(),确认全是dict - 用
df['info'].str.len().fillna(0)快速看字典长度分布,排查空/None - 如果键差异大,建议先用
df['info'].apply(lambda x: {k: v for k, v in x.items() if k in ['a', 'b', 'c']})显式过滤
合并回原表时,pd.concat(..., axis=1) 比 join 更稳
展开后得到一个新 DataFrame(比如叫 expanded),需要和原表拼回去。很多人习惯用 df.join(expanded),但默认左索引对齐,一旦原表索引被重排过、或中间有 dropna 等操作,就容易错位。
pd.concat([df, expanded], axis=1) 更可靠:它按位置拼接,只要 expanded 是由 df['col'].apply(...) 生成的,二者行数和顺序天然一致,不会因索引值变化而错行。
- 别忘了删掉原始字典列:
pd.concat([df.drop('info', axis=1), expanded], axis=1) - 如果原表索引不连续(比如经过
query或iloc),join更可能出问题,concat几乎无感 - 展开列名带点号或空格?
expanded.columns = [f'info_{c}' for c in expanded.columns]提前改好,避免后续引用麻烦
性能差?试试 pd.json_normalize 替代 apply(pd.Series)
当字典列超过几千行,apply(pd.Series) 会明显变慢——因为每行都新建一个 Series 对象,Python 层循环开销大。此时 pd.json_normalize(df['info']) 是更优选择,它是 C 实现的,专为嵌套 JSON/字典设计,速度通常快 3–5 倍。
注意 json_normalize 默认把嵌套字典也展开(比如 {'user': {'name': 'A', 'id': 1}} 会变成 user.name 和 user.id 两列),如果你只要一级 key,加参数 max_level=0:
pd.json_normalize(df['info'], max_level=0)
-
json_normalize对None和非字典值更敏感,遇到会报TypeError,需提前清洗:df['info'] = df['info'].apply(lambda x: x if isinstance(x, dict) else {}) - 它不依赖索引,返回的 DataFrame 行序严格对应输入序列,和
concat配合最稳妥 - 如果字典里有 list,
json_normalize默认会跳过;要展开 list 字段得用record_path参数,那是另一个场景了
键名含特殊字符或动态变化时,别硬展,考虑用 map 提取关键字段
不是所有字典列都适合全量展开。比如日志字段 'metadata' 里 key 每次都不一样({'req_id': 'x', 'trace_id': 'y'} vs {'session_id': 'z', 'region': 'cn'}),强行展开会导致列爆炸,且多数列长期为空。
这时更务实的做法是明确你要哪几个字段,用 .map() 单独提出来:
df['req_id'] = df['metadata'].map(lambda x: x.get('req_id') if isinstance(x, dict) else None)
df['trace_id'] = df['metadata'].map(lambda x: x.get('trace_id') if isinstance(x, dict) else None)
-
map比apply轻,不构造中间 DataFrame,内存友好 - 用
.get(key, default)避免KeyError,比直接x[key]安全得多 - 如果字段多且规律强(比如都以
'user_'开头),可以用df['metadata'].apply(lambda x: {k: v for k, v in x.items() if k.startswith('user_')}).apply(pd.Series)先过滤再展
apply(pd.Series) 报错,却会在下游计算中悄悄引入 NaN 或错列,等你发现时往往已跑完几轮分析。Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











