如何判断对象是否为原生dict类型

在Python中，若需严格区分原生dict与defaultdict、OrderedDict等子类（例如避免json.dumps异常或确保无额外行为），必须使用type(obj) is dict而非isinstance(obj, dict)，因为后者会因继承关系误判；但多数场景下应优先采用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 使用。

到这里，我们也就讲完了《如何判断对象是否为原生dict类型》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！