EnumMap和EnumSet是Java专为枚举优化的高效集合,底层基于数组/位图实现,O(1)时间复杂度、内存占用小、遍历有序,但要求元素必须为同一枚举类型且线程不安全。

EnumMap 和 EnumSet 是 Java 专为枚举类型优化的集合类,底层基于数组实现,性能远超 HashMap 和 HashSet。它们要求键(EnumMap)或元素(EnumSet)必须是同一枚举类型,且在创建时即确定类型,因此访问快、内存省、线程不安全但适合单线程高频场景。
EnumMap:用枚举做键的高性能映射
EnumMap 内部用数组索引代替哈希计算,put/get 时间复杂度为 O(1),且不接受 null 键(枚举实例天然非空)。
- 声明时必须指定枚举类,如 EnumMap
,不能用通配符或 Object - 自动按枚举定义顺序排列键(即 ordinal() 顺序),遍历时有序,无需额外排序
- 支持批量操作:keySet() 返回 EnumSet,values() 返回 Collection,entrySet() 可直接迭代
- 示例:统计订单状态分布
EnumMapcountMap = new EnumMap(OrderStatus.class);
countMap.put(OrderStatus.PAID, 120);
countMap.put(OrderStatus.SHIPPED, 85);
EnumSet:轻量级位向量实现的枚举集合
EnumSet 不是 HashSet 的替代品,而是用一个或多个 long 值(位图)表示元素存在性。最多支持 64 个枚举常量(单 long),超过则自动扩容为 long[],空间占用极小。
- 所有静态工厂方法(noneOf(), allOf(), range(), of())都返回不可变/可变子类,但统一接口为 EnumSet
- noneOf(Class) 最常用,创建空集;allOf(Class) 创建全量集;range(from, to) 包含 from 到 to(含两端)的所有枚举值
- 支持高效集合运算:union(), intersection(), complementOf() 等,底层是位运算,比循环 addAll 快得多
- 示例:权限控制中启用的功能集
EnumSetenabled = EnumSet.of(Feature.LOGIN, Feature.SEARCH);
EnumSetrequired = EnumSet.range(Feature.LOGIN, Feature.PAYMENT);
boolean hasAllRequired = enabled.containsAll(required);
配合使用:状态机与配置管理典型场景
EnumMap + EnumSet 组合特别适合状态流转校验、功能开关、角色权限等“枚举维度+属性绑定”模型。
- 用 EnumMap 存储每个状态对应的合法转移目标(值为 EnumSet),查询 O(1):
EnumMap> transitions = new EnumMap(State.class);
transitions.put(State.DRAFT, EnumSet.of(State.SUBMITTED, State.ARCHIVED)); - 避免反射或 if-else 链:根据当前状态直接 get() 得到允许的操作集,再检查用户权限 EnumSet 是否包含某操作
- 初始化建议放在 static 块或 Configuration 类中,保证单例、线程安全(构造后只读)
- 注意:EnumSet 不支持并发修改,多线程写入需外部同步;若需并发,改用 Collections.synchronizedSet(EnumSet...) 或考虑 CopyOnWriteArraySet(仅当读多写极少时)
避坑提醒:类型安全与生命周期约束
这两个集合的优势源于对枚举的强约束,但也是其局限所在——一旦枚举类变更(如删常量),运行时不会报错,但逻辑可能异常。
- EnumMap 中未显式 put 的枚举键,默认值为 null,get() 返回 null —— 使用前务必判空或用 getOrDefault(key, defaultValue)
- EnumSet 的 complementOf() 要求参数与自身类型一致,否则编译失败;且补集范围是该枚举类全部常量,不是当前 JVM 加载的子集
- 序列化兼容性:枚举常量名变更会导致反序列化失败(因依赖 name()),建议枚举类加 @Serial 注解并维护 serialVersionUID
- 不要试图往 EnumSet 中 add 非定义枚举值(编译不通过),也不要用父类引用接收 EnumSet(会丢失类型信息,影响泛型推导)










