Java中用枚举管理配置项是一种简洁、类型安全且易于维护的方式，通过枚举类统一收口配置，配合ConfigLoader实现安全读取与类型转换，并支持动态刷新和可维护性增强。
Java 中用枚举管理配置项是一种简洁、类型安全且易于维护的方式。它把分散在 properties、yml 或硬编码中的配置，统一收口到一个枚举类里，天然支持 IDE 自动补全、编译期校验和运行时快速查找。
定义配置枚举：字段 + 构造器 + getter
每个枚举常量代表一个配置项，携带 key、value、默认值、描述等信息。推荐使用私有字段 + 构造方法 + 公共 getter 的结构：
public enum ConfigKey {
// 配置项名(配置key, 默认值, 描述)
TIMEOUT("app.timeout.ms", "5000", "HTTP 请求超时毫秒数"),
RETRY_COUNT("app.retry.count", "3", "失败重试次数"),
ENABLE_CACHE("app.cache.enabled", "true", "是否启用本地缓存");
private final String key;
private final String defaultValue;
private final String description;
ConfigKey(String key, String defaultValue, String description) {
this.key = key;
this.defaultValue = defaultValue;
this.description = description;
}
public String getKey() { return key; }
public String getDefaultValue() { return defaultValue; }
public String getDescription() { return description; }
}
配合配置加载器：统一读取 + 类型转换
枚举本身不负责读配置，需搭配一个工具类（如 ConfigLoader）从 Spring Environment、Properties 或其他来源读取，并按枚举 key 匹配赋值。关键点是提供泛型化获取方法：
- 用
Environment.getProperty(key, defaultValue)安全读取 - 对布尔、数字等类型做自动转换（例如
Boolean.parseBoolean()） - 封装成静态方法，调用形如
ConfigLoader.get(RETRY_COUNT, Integer.class)
支持动态刷新（可选）：结合 Spring @RefreshScope 或事件监听
若配置可能运行时变更（如 Nacos、Apollo），可在枚举中增加 volatile 缓存字段，或让 ConfigLoader 实现 ApplicationRunner，监听配置变更事件后清空本地缓存。注意：枚举实例不可变，所以不能改枚举字段本身，而是更新外部缓存或代理对象。
立即学习“Java免费学习笔记（深入）”；
增强可维护性的小技巧
- 为枚举添加
fromKey(String key)静态方法，方便根据字符串反查枚举（用于配置中心回调） - 用
@Deprecated标记已下线的配置项，并在 description 中说明替代方案 - 测试时可遍历
ConfigKey.values()，校验所有 key 是否在配置文件中存在，避免遗漏
这种方式不依赖第三方框架也能工作，和 Spring Boot 的 @ConfigurationProperties 各有适用场景：枚举更适合少量核心、稳定、需强约束的配置；而配置类更适合结构复杂、嵌套多、需松耦合绑定的场景。
