Java原生Map不支持双向查找，因其仅保证键→值单向映射且值可重复；Guava的BiMap通过强制键值均唯一实现双向映射，提供inverse()视图并保障一致性。
Java原生Map根本不支持双向查找
Java标准库的 Map 接口只保证“键→值”单向映射，没有提供“值→键”的反向查询能力。这不是设计疏漏，而是接口契约明确限定：key 唯一、value 可重复——而双向映射（BiMap）要求键和值都唯一，否则反查会歧义。所以你写 map.get("apple") 能行，但想用 "red" 找出哪个键对应它？原生API里根本没这个方法。
Guava的BiMap才是真正的双向Map
Google Guava 库提供了 BiMap 接口及其实现类（如 HashBiMap、ImmutableBiMap），它强制约束“键唯一且值也唯一”，从而支持 inverse() 方法返回一个逻辑上的反向视图：
BiMap<String, Integer> biMap = HashBiMap.create();
biMap.put("apple", 1);
biMap.put("banana", 2);
BiMap<Integer, String> inverse = biMap.inverse(); // 不是新拷贝，是视图
System.out.println(inverse.get(1)); // 输出 "apple"
注意：inverse() 返回的是同一份数据的镜像，修改任意一方都会反映到另一方；插入重复值会抛 IllegalArgumentException，这是双向性的硬性保障。
自己模拟BiMap容易踩的坑
有人试图用两个 HashMap（正向+反向）手动维护双向关系，但极易出错：
立即学习“Java免费学习笔记（深入）”；
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 忘记同步更新：调用
put(k,v)后没同步删掉旧的反向映射，导致脏数据 - 没处理
null：原生HashMap允许null键/值，但BiMap禁止null值（否则inverse().get(null)无法定义） - 并发不安全：两个 map 的读写不是原子操作，多线程下可能看到不一致状态
- 内存泄漏风险：若 value 是大对象，反向 map 持有强引用，GC 无法回收
除非有极特殊限制（比如不能引入 Guava），否则别手写。Guava 的 BiMap 已经封装了所有边界检查和一致性逻辑。
什么时候该用BiMap而不是普通Map
典型场景非常具体，不是“看起来要双向”就该用：
- 枚举常量与字符串 ID 的互转（如
Status.PENDING ↔ "pending"） - 协议字段编码/解码（如 HTTP 状态码
200 ↔ "OK"） - 配置项别名映射（如
"max-conn" ↔ "maxConnections"，且不允许别名冲突）
如果只是偶尔根据 value 查 key，且能接受 O(n) 遍历（比如 entrySet().stream().filter(...).findFirst()），那用原生 HashMap + 显式遍历更轻量。强行上 BiMap 反而增加约束和学习成本。
真正关键的不是“能不能双向”，而是“值是否天然具备唯一性”。如果业务上 value 就可能重复，BiMap 根本就不适用——这时候得换思路，比如加一层索引或改用其他结构。
