应使用 type(obj) is dict 严格判断是否为原生 dict,因 isinstance(obj, dict) 会误判 defaultdict、OrderedDict 等子类,导致 json.dumps 等操作异常;若只需映射行为,应优先用 isinstance(obj, collections.abc.Mapping)。

用 type() 而不是 isinstance()
最直接的办法是检查对象的**确切类型**,而不是是否“属于某个类型族”。isinstance(obj, dict) 会返回 True 对于 defaultdict、OrderedDict(在 Python 3.7+ 的 CPython 中甚至对某些子类也成立),因为它们都继承自 dict。但如果你要确认它“就是原生 dict”,就得用 type(obj) is dict。
常见错误现象:写了个配置校验函数,以为 isinstance(data, dict) 就能拦住非 dict 输入,结果传入 defaultdict(int) 也能过,后续用 data.keys() 没问题,但用 json.dumps(data) 时行为异常(比如丢失插入顺序或默认工厂被序列化失败)——这往往是因为你以为它是纯 dict,实际却不是。
-
type(obj) is dict—— 严格匹配,只对内置dict实例返回True -
isinstance(obj, dict)—— 匹配所有dict子类,包括defaultdict、OrderedDict、ChainMap(注意:ChainMap其实不继承dict,但常被误判) - 别用
obj.__class__ == dict,虽然多数时候等价,但不如is安全(避免被猴子补丁干扰)
警惕 Python 版本和实现差异
OrderedDict 在 Python 3.7+ 的 CPython 中已不是“必须用的有序字典”——因为普通 dict 已保证插入顺序。但它的类型仍是独立的:type(OrderedDict()) is OrderedDict,且 type(OrderedDict()) is not dict。这点很稳定。
真正容易踩坑的是 defaultdict:它继承自 dict,所以 isinstance(defaultdict(), dict) 是 True,但 type(defaultdict()) is dict 是 False。另外,某些第三方库(如 types.MappingProxyType)或自定义类可能伪装成 dict 行为,但连继承都不做,这时 isinstance(..., dict) 也会是 False,而你可能误以为“至少它不是 dict 子类”,其实它根本就不是 dict 的任何变体。
- CPython 3.7+ 中:
dict有序,但OrderedDict仍是不同类,保留其特殊方法(如move_to_end()) - PyPy 或旧版本中:
dict无序,OrderedDict是唯一可靠有序选项,类型区分更关键 -
defaultdict的default_factory属性是公开的,可额外检查:hasattr(obj, 'default_factory')能快速排除它(但不能代替type()判断)
需要兼容鸭子类型?那就别硬判 dict
很多场景其实并不真需要“它必须是 dict”,而是需要“它支持 keys()、items()、方括号取值”。这时候强行用 type(obj) is dict 反而限制了灵活性,比如用户传个 dataclasses.asdict() 返回的普通 dict 没问题,但传个 types.MappingProxyType 就失败——尽管它完全满足接口。
如果逻辑确实依赖 dict 的特定行为(例如:要求 json.dumps() 输出不含额外字段、要求没有 default_factory、要求不记录访问顺序),那才值得做严格类型判断。否则,优先用 collections.abc.Mapping 做协议检查:
from collections.abc import Mapping isinstance(obj, Mapping) and not isinstance(obj, (str, bytes))
这样既放过 dict、defaultdict、OrderedDict,也接纳 MappingProxyType 和其他符合映射协议的对象。
最保险的判断组合
如果你既要“确实是 dict”,又要防极端情况(比如有人 monkey-patch 了 dict 类),可以加一层防御:
- 先用
type(obj) is dict快速判断 - 再验证关键属性是否存在且行为一致,例如:
hasattr(obj, 'keys') and callable(obj.keys) - 避免检查
__dict__或内部属性(如_keys),这些是实现细节,跨版本不稳定
真正难处理的不是 defaultdict 或 OrderedDict,而是那些只实现了部分 dict 接口的类(比如返回 dict 但重写了 __getitem__ 来触发计算)。这种情况下,类型判断毫无意义,得靠文档或契约约定——而这类对象,通常也不该被当成普通 dict 使用。










