Java枚举是继承自java.lang.Enum的真正类,需在类体开头显式定义常量,构造器必须private,字段建议private final,不可用new实例化,带参构造器要求所有常量提供对应参数。

Java 枚举(enum)不是“加强版常量类”,而是实实在在的类——它继承自 java.lang.Enum,能定义字段、方法、构造器,甚至实现接口。直接用 public static final String 模拟枚举,会丢失类型安全、序列化支持、switch 语义检查和反射元数据。
如何正确定义和初始化 enum
枚举常量必须在类体开头显式列出,每个常量可带参数并触发私有构造器;字段建议用 private final,避免意外修改。
- 构造器必须是
private(省略时默认即为 private) - 不能使用
new实例化枚举,MyEnum e = new MyEnum("x")编译不通过 - 若定义了带参构造器,所有枚举常量都必须提供对应参数,例如
RED(255, 0, 0) - 静态代码块和实例初始化块在枚举中允许,但极少需要;优先用构造器初始化字段
public enum Color {
RED(255, 0, 0),
GREEN(0, 255, 0),
BLUE(0, 0, 255);
private final int r, g, b;
Color(int r, int g, int b) {
this.r = r;
this.g = g;
this.b = b;
}
public int getRGB() {
return (r << 16) | (g << 8) | b;
}
}
为什么 switch 中用 enum 比用 String 更安全
switch 支持 enum 是从 Java 7 开始的,核心优势是编译期校验:未覆盖全部枚举常量时,IDE 和 javac 可提示警告(配合 -Xlint:fallthrough 或 sealed + exhaustive 检查更佳);而 String switch 仅做运行时字符串匹配,拼错值就进 default 分支,无提示。
-
Color c = Color.RED;在switch(c)中,IDE 能自动补全全部 case 分支 - 新增枚举值后,已有 switch 语句若未更新,编译器可配合
default报 warning(需开启-Xlint:switch) -
String值来自外部(如 JSON、HTTP 参数),无法保证只含预设值,容易漏处理
如何安全地将字符串转为 enum(避免 NullPointerException 和 IllegalArgumentException)
MyEnum.valueOf("XXX") 在值不存在时抛 IllegalArgumentException,且区分大小写;生产代码中不应裸调用它。
立即学习“Java免费学习笔记(深入)”;
- 推荐封装静态工具方法,返回
Optional或null,例如:parse(String s) - 若需忽略大小写,先用
MyEnum.values()遍历比对e.name().equalsIgnoreCase(s),不要用s.toUpperCase()再调valueOf(某些 locale 下"i".toUpperCase()不是"I") -
values()每次调用都新建数组,高频场景建议缓存为static final List或构建Map
public enum Status {
PENDING, PROCESSING, DONE;
public static Optional parse(String s) {
if (s == null) return Optional.empty();
try {
return Optional.of(valueOf(s.trim().toUpperCase()));
} catch (IllegalArgumentException e) {
return Optional.empty();
}
}
}
枚举实现接口与反序列化注意事项
枚举可实现任意接口(如 Runnable、JsonSerializable),但不可被继承(final 类),也不能有子类枚举。Jackson / Gson 默认支持枚举序列化为 name 字符串,但若重写了 toString() 或添加了 @JsonValue 方法,行为会改变。
- 反序列化时,默认按
name()匹配;若字段名是中文或带空格,需用@JsonProperty("已发货")标注对应常量 - 不要在枚举中保存可变状态(如
private Date lastUsed),违反枚举“单例+不可变”契约,多线程下易出错 - 若需扩展属性(如描述、排序权重),统一用
private final字段 + getter,别用静态 Map 映射,破坏封装性
最易被忽略的一点:枚举的 ordinal() 是编译序号,不是业务 ID——调整常量顺序、删中间项都会导致 ordinal() 错位,数据库里存 ordinal 或用于网络协议是危险操作。该用 name() 就用 name(),该用自定义 code 字段就加字段。










