应优先用 defaultdict 替代普通字典防 KeyError,它通过工厂函数(如 int、list)为缺失键提供默认值,仅方括号访问时触发;与 setdefault() 相比更适于键值关系固定、反复增删的场景。

用 defaultdict 替代普通字典,避免 KeyError
普通字典查不存在的键会直接抛 KeyError,而 defaultdict 能在首次访问缺失键时自动填一个默认值,不报错。它不是语法糖,是 collections 模块里的独立类型,行为和 dict 不完全一致。
- 必须传一个可调用对象(比如
list、int、str或 lambda)作为工厂函数,不能传具体值(如defaultdict(0)是错的) - 只有在用方括号访问缺失键时才触发默认值生成(
.get()仍返回None或你给的 fallback) -
defaultdict(int)的默认值是0,defaultdict(list)是空列表,defaultdict(str)是空字符串
defaultdict 和 dict.setdefault() 怎么选
两者都能防 KeyError,但适用场景不同:前者适合「键值关系固定、反复增删」,后者适合「单次兜底、逻辑简单」。
-
defaultdict在初始化阶段就决定了所有缺失键的行为,后续所有[key]访问都自动生效;setdefault()每次都要显式调用,比如d.setdefault('a', []).append(1) -
setdefault()的默认值只在键不存在时设置一次,之后再调不会覆盖;defaultdict每次新建键都调用工厂函数,所以defaultdict(list)每个新键都得到一个全新空列表 - 如果只是偶尔查一下缺不缺键,用
in判断或.get()更轻量,没必要上defaultdict
常见踩坑:嵌套 defaultdict 写法和类型提示
想实现「字典套字典套列表」这种结构,容易写错工厂函数,导致所有键共享同一个内层容器。
- 错误写法:
defaultdict(defaultdict(list))——defaultdict(list)是实例,不是可调用对象,会报TypeError - 正确写法:
defaultdict(lambda: defaultdict(list))或defaultdict(partial(defaultdict, list)) - 类型提示要小心:mypy 默认不识别
defaultdict的默认值行为,建议用Dict[K, V]+ 注释说明,或显式标注为DefaultDict[K, V]并配from collections import defaultdict - 序列化(如
json.dumps)前必须转成普通dict,否则会报TypeError: Object of type defaultdict is not JSON serializable
不用 defaultdict 也能解决?看这几个替代方案
不是所有场景都值得引入 defaultdict,尤其当逻辑简单或仅需一次兜底时。
立即学习“Python免费学习笔记(深入)”;
- 查键存在性:
if 'key' in d:最直白,无副作用 - 取值带默认:
d.get('key', []),注意默认值是表达式结果,不是每次调用都重算(除非用 lambda 包一层) - 需要赋值且兜底:
d.setdefault('key', []).append(x),比defaultdict多一次方法调用,但语义更明确 - Python 3.8+ 可用海象运算符:
if (v := d.get('key')) is None: d['key'] = v = [],但可读性差,一般不推荐
真正该用 defaultdict 的时候,是你发现代码里反复出现 .setdefault 或 if key not in d: d[key] = ...,而且键的默认类型很统一。这时候换掉,代码反而更干净。其他时候,别为了“炫技”硬套。


















