如何判断一个对象是否真的是 dict 而不是 defaultdict 或 OrderedDict

应使用 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 使用。