Java EnumSet用法：位向量实现高效枚举集合

Java EnumSet 是一种专为枚举类型优化的高性能集合实现，底层采用位向量（long 或 long[]）进行存储，所有操作均为 O(1) 位运算，彻底规避了哈希冲突、装箱拆箱及对象内存开销，因而远超 HashSet 的速度与空间效率；但它严格限定于编译期已知的单一枚举类型，不支持 null、动态值或跨类型混用，且易在反序列化、集合转换和只读封装等场景中踩坑——掌握其设计边界与正确用法（如优先使用 noneOf()/allOf()/of() 工厂方法、避免 stream 转普通 Set、显式处理序列化），才能真正释放其极致性能红利。

EnumSet 为什么比 HashSet 快得多

因为 EnumSet 内部用的是 long 或 long[] 当位向量，每个枚举常量对应一个 bit 位 —— 插入、查找、删除全是位运算，O(1) 且无哈希冲突、无装箱开销。

但代价是：它只能存一种枚举类型，且必须在编译期已知所有值（也就是你定义的 enum 里的全部常量）。拿 HashSet 去比内存占用或迭代速度，基本没赢过。

常见错误现象：EnumSet.of(null) 直接抛 NullPointerException；传入非声明枚举类型的值（比如反射构造）会编译不过或运行时报 ClassCastException。

创建 EnumSet 的三种安全方式

别用 new EnumSet —— 它是抽象类，不能直接实例化。JVM 根据元素数量自动选 RegularEnumSet（≤64 个值）或 JumboEnumSet（＞64）。

• EnumSet.noneOf(MyEnum.class)：空集合，最常用，推荐作为初始化起点
• EnumSet.allOf(MyEnum.class)：包含该 enum 所有常量，注意别在 enum 常量很多时滥用（比如上百个）
• EnumSet.of(MyEnum.A, MyEnum.B, MyEnum.C)：可变参，最多传 5 个参数；超过要用 EnumSet.complementOf() 或先建再 addAll()

参数差异：所有工厂方法第一个参数都是 Class，必须是你 enum 的字节码对象，不能是父类或接口；传错类型（比如 String.class）编译就报错。

EnumSet 不支持 null 和动态枚举值

这是硬限制，不是 bug。任何尝试添加 null 的操作（add(null)、of(null)、copyOf(Arrays.asList(null))）都会立即抛 NullPointerException。

使用场景中容易踩坑的地方：

• 从 JSON 反序列化或数据库查出字符串后，想转成 enum 再塞进 EnumSet，但没校验字符串是否合法 —— MyEnum.valueOf("XXX") 会抛 IllegalArgumentException，得提前兜住
• 用 EnumSet.copyOf(Collection) 时，Collection 里混了非当前 enum 类型的实例（比如子类伪装），运行时报 ClassCastException
• 误以为 EnumSet 能像 TreeSet 那样自定义顺序 —— 它的迭代顺序永远是 enum 声明顺序，改不了

和普通 Set 混用时的隐式转换陷阱

EnumSet 实现了 Set 接口，但它的泛型擦除后是 Set，不是裸 Set。传给期望 Set