enummap 比 hashmap 存枚举更快,因其用数组实现,索引由枚举 ordinal() 直接决定,省去 hash 计算、寻址、扩容及树化等开销,且内存局部性好、分支预测友好。

EnumMap 为什么比 HashMap 存枚举更快
因为 EnumMap 内部用数组而非哈希表实现,索引直接由枚举的 ordinal() 值决定,跳过了 hash 计算、寻址、扩容、链表/红黑树转换等全部开销。只要枚举类定义稳定(不频繁增删值),它就是最轻量、最确定的枚举键映射结构。
常见错误现象:HashMap<myenum v></myenum> 被误用于纯枚举键场景,尤其在高频调用或低延迟服务中,多出的 hash 和装箱开销会累积成可观差异。
- 使用场景:状态码转描述、协议字段名映射、配置开关枚举 → 值对、权限枚举 → 权限校验函数引用
-
EnumMap不接受null键(枚举本身不能为null),但允许null值;HashMap两者都允许,这是语义差异,不是 bug - 构造时必须传入枚举类字面量:
new EnumMap(MyEnum.class)—— 少了这句,编译不过
EnumMap 初始化时必须指定枚举类
它不像 HashMap 那样靠泛型推断运行时类型,而是依赖构造参数中的 Class<e></e> 显式告知“这个 map 只存哪种枚举”。这是它能用数组做底层的关键前提。
容易踩的坑:EnumMap<myenum string> map = new EnumMap(someOtherEnum.class)</myenum> 编译报错;更隐蔽的是泛型擦除后误传父类或接口,比如传 Enum.class,直接 ClassCastException。
立即学习“Java免费学习笔记(深入)”;
- 正确写法只有这一种:
new EnumMap(MyEnum.class) - 如果枚举类是泛型类型参数(如方法内),需通过
clazz参数传入,不能用T.class(泛型无法获取) - 初始化后,
map.size()返回的是已 put 的键数,不是枚举总常量数;map.keySet()返回的是EnumSet,不是普通Set
EnumMap 不支持非枚举键,也不兼容其他 Map 接口行为
它压根没实现 containsKey(null) 这类逻辑——因为枚举键不可能为 null,所以调用它会直接抛 NullPointerException,而不是返回 false。这不是缺陷,是设计取舍。
常见错误现象:把 EnumMap 当作 HashMap 替代品,在已有通用 Map 处理逻辑里硬塞进去,结果在 keySet().stream().filter(...) 或第三方工具类遍历时触发 NPE 或 ClassCastException。
- 不能用在需要“任意键类型”的泛型方法里,除非限定上界为
E extends Enum<e></e> -
EnumMap的keySet()是EnumSet,迭代顺序严格按枚举声明顺序,不是插入顺序,也不是自然顺序 - 序列化兼容性没问题,但反序列化时仍需提供对应枚举类(JVM 必须能加载该类)
EnumMap 和 IdentityHashMap 在枚举场景下的对比误区
有人觉得“枚举实例唯一”,就选 IdentityHashMap 来避免 hash 冲突,这是典型误解。EnumMap 根本不用 hash,而 IdentityHashMap 仍要计算 identity hash、处理扩容、且 key 比较用 ==,对枚举来说既无必要又更慢。
性能实测(JDK 17,百万次 put/get):EnumMap 约 25ms,IdentityHashMap 约 68ms,HashMap 约 42ms。差距来自内存局部性和分支预测友好度。
-
EnumMap的数组长度 = 枚举常量数,无浪费空间;IdentityHashMap默认初始容量 32,可能扩容多次 - 不要为了“看起来更通用”而放弃
EnumMap—— 它的类型安全和性能优势只在明确知道键是枚举时才成立 - 如果枚举类未来可能被替换成非枚举(比如从
Status改成字符串码),那就别用EnumMap,换回HashMap并加好注释
真正要注意的,是枚举类一旦被修改(比如删掉中间某个常量),ordinal() 重排会导致 EnumMap 里旧数据错位——这种破坏是静默的,不会报错,只会在运行时读出错误值。









