判断对象是否支持__getitem__方法

本文深入探讨了如何准确识别“行为像字典但不是 dict 本身”的对象，指出简单使用 `hasattr(obj, '__getitem__')` 会导致严重误判（如将列表、字符串等序列类型错误归类），强调应采用 `isinstance(obj, collections.abc.Mapping) and not isinstance(obj, dict)` 这一组合判断——它既严格遵循映射协议（要求 `__getitem__`、`__iter__`、`__len__` 等核心方法，确保键值语义和任意不可变键支持），又能正确涵盖通过 `register()` 注册的虚拟子类（如 `MappingProxyType`、`defaultdict`），同时精准排除原生 `dict`；该方法轻量、可靠、兼容现代 Python，并规避了 `issubclass` 无法识别虚拟继承、手动检查协议易出错等常见陷阱，是识别非 dict 字典式对象的权威实践。

用 collections.abc.Mapping 判断是否是 dict-like 但排除 dict 本身

直接检查 hasattr(obj, '__getitem__') 太宽泛——列表、字符串、自定义类只要实现了 __getitem__ 就会返回 True，但这不表示它支持键值语义。真正想识别的是“行为像字典”的对象（支持任意不可变键、有映射语义），又明确不是 dict 实例。

推荐方式是组合判断：isinstance(obj, collections.abc.Mapping) 确保它符合映射协议（要求实现 __getitem__、__iter__、__len__），再用 not isinstance(obj, dict) 排除原生 dict：

import collections.abc

def is_mapping_not_dict(obj):
    return isinstance(obj, collections.abc.Mapping) and not isinstance(obj, dict)

注意：这个判断不会把 collections.defaultdict 或 types.MappingProxyType 当作 dict 排除，它们是合法的非 dict 映射。

为什么不用 issubclass(type(obj), collections.abc.Mapping)

用 isinstance 而不是 issubclass(type(obj), ...)，是因为很多类型（比如 types.MappingProxyType）并未显式继承 collections.abc.Mapping，而是通过 register() 注册为虚拟子类。只有 isinstance 能正确识别这类注册关系。

• isinstance({}, collections.abc.Mapping) → True
• isinstance(types.MappingProxyType({'a': 1}), collections.abc.Mapping) → True
• issubclass(type(types.MappingProxyType({})), collections.abc.Mapping) → False

常见误判场景和绕过方法

有些对象看似支持 __getitem__，但不符合映射语义（比如只接受整数索引），collections.abc.Mapping 协议能自然过滤掉它们：

• list、tuple、str：有 __getitem__，但不实现 __iter__ 返回键（而是返回元素），所以 isinstance(..., Mapping) 为 False
• collections.OrderedDict：是 Mapping，且不是 dict（Python 3.7+ 后 dict 有序，但 OrderedDict 仍是独立类型），会被保留
• 自定义类只实现 __getitem__ 但没实现 keys() 或没注册 Mapping：默认不被识别，避免误判；若真需支持，应显式 collections.abc.Mapping.register(MyClass)

性能与兼容性提醒

isinstance(obj, collections.abc.Mapping) 是轻量级协议检查，不触发任何方法调用，开销可忽略。但在 Python collections.abc 的某些子类注册行为略有差异，建议统一用 import collections.abc 而非旧式的 import collections。

如果目标环境必须兼容 Python 2，这条路走不通——那时没有 collections.abc，只能退回到手动检查三个方法是否存在并尝试调用，但极易出错，不建议。

真正难处理的是那些故意模仿 dict 行为但未注册协议的类，这种情况下，你得看它的文档或源码，协议检查帮不上忙。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。