如何通过 EnumSet.allOf() 方法高效获取 Java 枚举类所有常量集合？

本文共计878个文字，预计阅读时间需要4分钟。

`EnumSet.allOf()` 方法只能用于枚举类型，且必须传入该枚举的 `Class` 对象。它底层依赖于枚举类的 `values()` 方法。因此，要求枚举类型不能是匿名子类或动态生成的（如反射构造的）。否则，会抛出 `IllegalArgumentException`。

• 必须传入具体枚举类的 Class，例如 Color.class，不能传 Object.class 或父类
• 枚举类中不能有未初始化的字段（如在 static 块中抛异常），否则 allOf() 调用时可能触发 ExceptionInInitializerError
• 返回的是不可变结构但可变内容的集合——你不能 add() 或 remove()，但可以 clear()（清空后集合变空，不再是“全量”）

为什么不用 values() 直接转 List 而要用 EnumSet.allOf()？

EnumSet 是专门为枚举设计的高性能集合实现，底层用位向量（long 或 long[]）表示，空间占用极小、遍历和 contains 操作都是 O(1)。而 Arrays.asList(Color.values()) 返回的是固定大小的 ArrayList，既不支持增删，又没做位运算优化。

• EnumSet.allOf(Color.class) 创建的是可修改的集合（支持 retainAll()、removeAll() 等），而 Arrays.asList(...) 返回的列表调用 remove() 会抛 UnsupportedOperationException
• 如果后续要频繁做集合运算（如求差集、并集），EnumSet 比 HashSet 或 ArrayList 快一个数量级
• 注意：它不是线程安全的，多线程并发修改需外加同步

常见误用与运行时错误

最常遇到的是泛型擦除导致的编译通过但运行失败：

• 错误写法：EnumSet.allOf((Class) MyEnum.class) —— 强制转型绕过编译检查，一旦传错类，运行时报 ClassCastException 或 IllegalArgumentException: Not an enum type
• 错误写法：EnumSet.allOf(SomeInterface.class) —— 即使枚举实现了该接口，也必须传枚举自身 Class
• 错误写法：EnumSet.allOf(null) —— 直接 NullPointerException
• 若枚举常量超过 64 个，EnumSet 自动切换为 RegularEnumSet（基于 long[]），行为一致，但要注意某些旧 Android 版本对大枚举的位操作有兼容性问题

一个安全封装的工具方法示例

如果你经常需要获取全量枚举集合并避免手写 .class，可以这样封装（注意泛型边界）：

立即学习“Java免费学习笔记（深入）”；

public static <E extends Enum<E>> EnumSet<E> allOf(Class<E> enumClass) { return EnumSet.allOf(enumClass); }

调用时：
EnumSet<Status> all = Utils.allOf(Status.class);

这个签名强制了 E 是枚举，编译器会在传入非枚举类时报错，比裸调 EnumSet.allOf() 更健壮。

EnumSet 的“全量”语义只在创建那一刻成立；如果后续代码中新增了枚举常量但没重新编译调用方，allOf() 仍只返回旧版本的全部常量——这点容易被忽略，尤其在热更或模块化部署场景下。