生产环境推荐 pybloom_live：开箱即用，依赖 bitarray；需合理设置 capacity（预期最大元素数）和 error_rate（默认 0.01）；注意类型一致、不可删除、pickle 跨环境易失败、非进程安全。
布隆过滤器在 Python 里到底该用哪个库
生产环境别碰 pybloom（已停止维护，Python 3.8+ 兼容差），也别手写——误判率、内存控制、序列化全得自己扛。主流选 pybloom_live 或 bitarray + 自封装，前者开箱即用，后者更轻但要自己算参数。
安装命令就一条：
pip install pybloom_live。注意：它依赖
bitarray，Windows 用户如果报 Microsoft Visual C++ 14.0 is required，先装 pip install --only-binary=bitarray bitarray 再装 pybloom_live。
初始化时怎么设 capacity 和 error_rate
这两个参数不能拍脑袋定。capacity 是你「预期最多存多少个不重复元素」，不是当前数据量；error_rate 是你容忍的「把不存在的值误判为存在」的概率，默认 0.01（1%）够用，压到 0.001 会显著涨内存。
- 比如预估要塞 100 万 URL，允许误判率 ≤0.1%，就写
BloomFilter(capacity=1_000_000, error_rate=0.001) - 如果实际插入超了
capacity，误判率会指数级上升，不是线性变差 - 没法定制哈希函数，底层用的是 Murmur3，对 URL、ID 类字符串友好，但对含大量中文或特殊符号的字段，建议先做简单归一化（如转小写、去空格）再喂进去
add() 和 __contains__() 的行为陷阱
这是最常踩的坑：add() 永远不报错，哪怕传 None 或字节串混用；__contains__()（也就是 if x in bf:）只返回 True/False，且 True 表示「可能在」，False 才表示「肯定不在」。
立即学习“Python免费学习笔记（深入）”；
- 别用
add()返回值做判断——它永远返回None - 传入类型必须一致：如果用字符串初始化，就别穿
bytes；否则bf.add(b"abc")和"abc" in bf一定返回False（底层哈希值不同） - 不支持删除操作，删了会污染其他元素，真要删请换
CountingBloomFilter（pybloom_live里有，但内存翻倍）
持久化保存和跨进程共享要注意什么
BloomFilter 对象本身可直接用 pickle 序列化，但文件不是“即拿即用”的二进制 blob，而是带 Python 版本和类路径的 pickle 流，换环境容易炸。
- 保存用：
with open("bf.bf", "wb") as f: pickle.dump(bf, f) - 加载前必须确保 Python 版本、
pybloom_live版本、甚至模块路径一致，否则报AttributeError: 'BloomFilter' object has no attribute '_bits' - 跨进程读写同一个文件？不行。它不是线程安全的，更不是进程安全的——多个进程同时
add()会丢数据。要用就上 Redis +redisbloom，或者用文件锁临时兜底
真正难的从来不是“怎么加”，而是预估容量时不贪小、查数据时不把 True 当确定、存下来后不以为能随便挪环境。这些点漏一个，线上就变成“为什么昨天还行，今天漏了一半？”
