Python类必须显式实现__contains__才能高效安全支持in运算符，否则会回退到低效且不可控的__iter__或__getitem__模拟查找；该方法必须返回布尔值且与__eq__逻辑一致。
Python 类默认不支持 in 运算符，必须显式实现 __contains__ 才能用 item in obj 语法——否则会回退到遍历 __iter__ 或逐个索引 __getitem__，效率低且行为不可控。
为什么不能只靠 __iter__ 或 __getitem__
当类没定义 __contains__ 时，Python 会尝试用迭代或下标方式模拟查找：先调 __iter__ 得到迭代器，再逐个比对；若没 __iter__，就从索引 0 开始调 __getitem__ 直到抛出 IndexError。这在数据量大、查找频繁或逻辑本不该可迭代时非常危险。
- 数据库封装类如果没
__contains__，"user123" in db可能触发全表扫描 - 稀疏结构（如只存了 key 的 set-like 容器）用迭代模拟会浪费大量时间跳过空槽位
- 某些对象逻辑上不可迭代（比如一个带缓存的单例配置），却被迫实现
__iter__来让in工作
__contains__ 必须返回布尔值，且不能抛异常代替 False
该方法接收一个参数（待查项），必须明确返回 True 或 False。返回其他类型（如 None、整数、字符串）会导致 TypeError；抛出未捕获异常（如 KeyError）也不会被吞掉，而是直接冒泡。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 错误写法：
def __contains__(self, key): return self.data[key]—— 若key不存在，抛KeyError，不是False - 正确写法：
def __contains__(self, key): return key in self.data（假设self.data是 dict/list） - 自定义逻辑示例：
def __contains__(self, x): return isinstance(x, int) and 0 <= x <= 100
和 __eq__ 配合时要注意相等逻辑一致性
__contains__ 内部通常依赖成员的相等判断。如果类重写了 __eq__，但 __contains__ 里用了 is 或 == 以外的方式比较（比如只比 id），就会出现 x in container 返回 False，但 x == list(container)[0] 却为 True 的矛盾。
立即学习“Python免费学习笔记（深入）”；
- 常见坑：
__contains__直接遍历并用is比较，而__eq__基于字段内容——导致“内容相同但不被识别为存在” - 安全做法：优先复用已有的相等逻辑，例如
any(item == target for item in self._items)，或直接委托给底层容器的in - 性能敏感场景可单独优化，但务必保证语义一致：若
a == b为真，那么a in [b]和b in [a]都应为真
最常被忽略的一点是：即使你的类只是简单包装一个 list 或 dict，也建议显式实现 __contains__——不只是为了性能，更是为了把“是否存在”的语义明确收口，避免使用者误以为它支持任意可迭代协议或下标访问。
