Python字典实现一键多值映射：defaultdict与setdefault用法详解

Jasper

发布时间：2026-10-13| 3人浏览过

原创

本文介绍Python中实现字典一键多值映射的两种主要方法。通过collections模块的defaultdict类可自动初始化列表或集合，简化代码；也可使用普通字典配合setdefault()方法手动处理。文章包含具体代码示例，对比两种方式的实现细节与适用场景，帮助开发者高效构建多值字典结构。

本文介绍在Python字典中将单个键映射到多个值的具体实现方法，供读者参考学习。

核心问题：如何构建一个支持一个键对应多个值的字典结构（即多值字典，multidict）。

解决思路：若需让一个键关联多个值，需将这些值存储于列表或集合等容器中。

>>> d={'a':[1,2,3],'b':[4,5]}
>>> d
{'b': [4, 5], 'a': [1, 2, 3]}
>>> e={'a':{1,2,3,3},'b':{4,5}}
>>> e
{'b': {4, 5}, 'a': {1, 2, 3}}
>>> f={'a':[1,2,3,3],'b':[4,5]}
>>> f
{'b': [4, 5], 'a': [1, 2, 3, 3]}
>>>

更便捷的构建方式是使用collections模块中的defaultdict类。该类的特性是自动为字典初始化首个值，因此只需直接添加元素即可。示例如下：

from collections import defaultdict
d=defaultdict(list) #创建一键多值的字典，key的value是list类型
d['a'].append(1)
d['a'].append(2)
d['a'].append(2)
d['b'].append(4)
c=defaultdict(set) #创建一键多值的字典，key的value是set类型
c['a'].add(1)
c['a'].add(2)
c['a'].add(2)
c['b'].add(4)
print('key的value是list类型的字典：',d)
print('key的value是set类型的字典：',c)

>>> ================================ RESTART ================================
>>>
key的value是list类型的字典： defaultdict(<class 'list'>, {'b': [4], 'a': [1, 2, 2]})
key的value是set类型的字典： defaultdict(<class 'set'>, {'b': {4}, 'a': {1, 2}})
>>>

使用defaultdict时需注意，它会自动创建字典项以备后续访问（即使这些项当前不存在于字典中）。

若需禁用此自动创建功能，可在普通字典上调用setdefault()方法替代，例如：

d={} #一个普通的字典
d.setdefault('a',[]).append(1)
d.setdefault('a',[]).append(2)
d.setdefault('a',[]).append(2)
d.setdefault('b',[]).append(4)
>>>

以下是键值对为列表类型的字典示例：

{'a': [1, 2, 2], 'b': [4]}

补充说明：

构建一键多值字典相对简单，但若手动初始化第一个值，代码会显得繁琐；使用defaultdict可使代码更加简洁：

pairs={'a':[22,44],'b':[88]}
d=defaultdict(list)
for key,value in pairs.items():
  d[key].append(value)
print (d)
>>>
defaultdict(<class 'list'>, {'a': [[22, 44]], 'b': [[88]]})
>>>

（代码示例源自《Python Cookbook》）

感兴趣读者可进一步阅读本站相关专题：《Python数据结构与算法教程》、《Python函数使用技巧总结》、《Python字符串操作技巧汇总》、《Python入门与进阶经典教程》及《Python文件与目录操作技巧汇总》。

希望本文内容对您的Python编程实践有所帮助。