推荐在 Java 枚举中定义业务字段（如 desc）并提供 getter 方法，而非直接重写 toString()；可选择性重写 toString() 但会覆盖默认名称，更佳实践是保留 toString() 返回常量名，另提供 display() 等专用展示方法，并添加 fromCode() 等静态查找方法。
在 Java 中，自定义枚举重写 toString() 是让枚举值输出业务友好文本的常用方式，但要注意：直接重写 toString() 会覆盖默认行为（即返回枚举常量名），且无法区分「调试用名称」和「展示用文本」。更推荐的做法是定义一个业务字段 + 对应的 getter 方法，再按需重写 toString() 或提供专用展示方法。
定义业务描述字段
在枚举中声明一个私有字段（如 desc），并在每个常量后传入对应文本：
public enum OrderStatus {
PENDING("待支付"),
PAID("已支付"),
SHIPPED("已发货"),
COMPLETED("已完成"),
CANCELLED("已取消");
private final String desc;
OrderStatus(String desc) {
this.desc = desc;
}
public String getDesc() {
return desc;
}
}
选择性重写 toString()（谨慎使用）
如果确实希望调用 toString() 就返回业务文本，可重写它，但需注意这会影响日志、调试等场景中对枚举原始名称的识别：
- 重写后
OrderStatus.PAID.toString()返回"已支付"，不再是"PAID" - 若仍需获取原始名称，可用
name()方法 - 重写示例：
@Override
public String toString() {
return desc;
}
更推荐：提供专用展示方法
保留 toString() 的默认语义（返回常量名），另加一个如 display() 或 label() 方法返回业务文本：
- 语义清晰，不破坏枚举契约
- 便于在不同上下文（如前端展示、日志记录）中灵活选择
- 示例：
public String display() {
return desc;
}
// 使用：OrderStatus.PAID.display() → "已支付"
// 调试时仍可用 OrderStatus.PAID.name() → "PAID"
支持根据 code 或 name 查找枚举
实际业务中常需通过字符串反查枚举，可添加静态查找方法提升实用性：
public static OrderStatus fromCode(String code) {
for (OrderStatus status : values()) {
if (status.name().equalsIgnoreCase(code)) {
return status;
}
}
throw new IllegalArgumentException("Unknown order status: " + code);
}
// 或按 desc 查找（需注意 desc 不一定唯一）
public static OrderStatus fromDesc(String desc) {
for (OrderStatus status : values()) {
if (status.desc.equals(desc)) {
return status;
}
}
return null;
}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
