布谷鸟哈希插入易死循环，因hash1与hash2强相关、无踢出轮数限制、负载因子过高致空位稀缺；需设MAX_RETRIES≈500、检测环路、扩容至1.3~1.5倍，并用独立哈希函数（如BKDR与FNV-1a）及质数表长。
布谷鸟哈希在 C++ 中无法靠“双表 + 踢出”就直接跑通，核心卡点是循环踢出时的死锁风险和空间利用率陷阱——不控制踢出轮数、不预留空位、不处理哈希函数弱相关性，插入操作大概率无限循环或提前失败。
为什么 insert 会死循环？
布谷鸟哈希的插入逻辑本质是“找两个位置，任选一个塞进去，把原值踢到它自己的另一个位置，再递归处理”。但现实中：
– 如果两个哈希函数 hash1 和 hash2 输出高度相关（比如都用 key % N，仅偏移不同），多个 key 可能形成环状依赖；
– 没有踢出次数上限时，哪怕表未满，也可能陷入无限踢出链；
– 表接近满载（负载因子 > 0.9）时，空位稀缺，踢出后无处安放，失败概率陡增。
常见错误写法是直接 while 循环重试，不设 MAX_RETRIES 或设得过大（如 1000），结果调试时卡住却查不到原因。
实操建议：
– 固定最大踢出轮数，推荐 MAX_RETRIES = 500（实测在负载因子 0.85 下成功率 > 99.9%）；
– 每次踢出前检查是否已循环回到起点（用 std::unordered_set 记录访问过的 key 或位置索引）；
– 插入失败后必须触发扩容（不能只报错），且新表大小建议为原大小的 1.3~1.5 倍（非简单翻倍），避免哈希分布重复。
立即学习“C++免费学习笔记（深入）”；
两个哈希函数怎么写才不互相干扰？
若 hash1(k) 和 hash2(k) 输出强相关，所有 key 的两个候选桶会集中在同一片区域，布谷鸟机制形同虚设。典型错误是：
– 用相同算法加固定偏移：hash1(k) = k % N, hash2(k) = (k + 1) % N；
– 对 string 类型两个函数都用 BKDR 但乘数相同；
– 浮点 key 直接转整再取模，丢失精度且易撞桶。
正确做法：
– hash1 用 BKDR（乘数 31），hash2 改用 FNV-1a 变体（异或+乘数 16777619）；
– 整型 key：一个用 key % N，另一个用 (key * 2654435761U) >> (32 - bits)（黄金比例移位法）；
– 所有函数必须接收 const Key&，string 类型严禁值传参；
– 每次扩容后必须重新初始化两个函数实例（避免旧种子残留）。
如何让内存占用比 std::unordered_map 更低？
标准库容器每个节点带指针和内存对齐填充，而布谷鸟哈希可全用紧凑数组：
– 用两个 std::vector<:pair value>></:pair> 存储，而非 std::vector<:list>></:list>；
– 不存状态标记（如 empty/exist），空位用 std::optional 或特化哨兵值（如对 int 用 INT_MIN）；
– 关键优化：插入时若发现某表中对应位置为空，直接写入，**不分配任何额外内存**；只有踢出时才覆盖原值，零 new/delete。
注意点：
– std::optional 在小类型上开销略大，可手写轻量 TaggedValue 结构体（含 bool flag + union）；
– vector 预留空间必须用 reserve()，不能依赖 push_back 自动扩容（否则迭代器失效，踢出链断裂）；
– 删除操作不真正擦除，只置空位标记，后续插入优先复用——这省掉移动成本，但需定期 compact（当空位占比 > 30% 时触发）。
最易被忽略的是：布谷鸟哈希的“空间优势”完全依赖于两个哈希函数的独立性与表尺寸的质数特性。用合数尺寸（如 1000）会导致大量位置不可达；函数不独立则等效单表链地址法——此时你写的不是布谷鸟，只是个更慢的哈希表。
