本文详解 boolean 基本类型字面量（如 true/false）与 Boolean 包装类常量（如 Boolean.TRUE/Boolean.FALSE）的本质区别、适用场景及最佳实践，重点聚焦语义清晰性、空安全性与代码一致性，而非性能微优化。
本文详解 `boolean` 基本类型字面量（如 `true`/`false`）与 `boolean` 包装类常量（如 `boolean.true`/`boolean.false`）的本质区别、适用场景及最佳实践，重点聚焦语义清晰性、空安全性与代码一致性，而非性能微优化。
在 Java 开发中，true 和 Boolean.TRUE 虽然逻辑等价，但类型、用途和语义层级截然不同：前者是原始 boolean 类型的字面量，后者是 Boolean 包装类的静态不可变实例（即 public static final Boolean TRUE = new Boolean(true);）。理解何时用哪一个，关键在于明确你的上下文需要的是「原始值」还是「可为空的对象引用」。
✅ 推荐优先使用 true / false 的场景
当目标变量或表达式类型为 boolean（原始类型），且你不涉及空值处理或泛型约束时，应无条件使用字面量：
// ✅ 正确：简洁、高效、语义直接
boolean isActive = config.getBoolean("feature.enabled", true);
boolean isPresent = Optional.ofNullable(user).isPresent(); // isPresent() 返回 boolean
boolean isValid = StringUtils.isNotBlank(input);
// ❌ 不必要：引入冗余装箱，降低可读性
boolean isActive = Boolean.TRUE; // 编译通过，但语义混淆（为何用对象赋值给原始类型？）JVM 会对 true/false 进行常量折叠，而 Boolean.TRUE 每次引用虽不创建新对象（因是静态 final），但仍需通过引用访问——对原始类型赋值而言纯属画蛇添足。
✅ 必须使用 Boolean.TRUE / Boolean.FALSE 的场景
仅当类型契约强制要求 Boolean 对象时才使用包装类常量，典型包括：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
-
泛型容器（如 List
、Map ） - 反射调用或序列化框架（如 Jackson、Hibernate）要求非基本类型字段
- 显式表示“三态”语义（true / false / null 表示“未设置”）
- 需安全判空的布尔比较（避免 NullPointerException）
// ✅ 场景1：泛型集合必须存对象
List<Boolean> results = Arrays.asList(Boolean.TRUE, Boolean.FALSE, null);
// ✅ 场景2：安全判空 —— 推荐写法（null-safe）
Boolean flag = getUserPreference("sms_enabled");
if (Boolean.TRUE.equals(flag)) { // 安全！flag == null 时返回 false
sendSms();
}
// ❌ 危险写法（可能 NPE）
// if (flag && flag.booleanValue()) { ... }
// ✅ 场景3：API 明确要求 Boolean 类型参数
someService.updateStatus(userId, Boolean.TRUE); // 方法签名：void updateStatus(long id, Boolean enabled)⚠️ 关于团队规范的理性看待
你团队 Leader 提议统一用 Boolean.TRUE，出发点可能是追求“类型一致性”或“避免原始类型与包装类混用”。但需注意：强制将 boolean 变量赋值为 Boolean.TRUE 是反模式。例如：
// ❌ 违背直觉且无益处
boolean isCalledFromAction = Optional.ofNullable(...)
.map(val -> Boolean.TRUE) // 返回 Boolean，再自动拆箱为 boolean
.orElse(Boolean.FALSE); // 同样拆箱这不仅增加不必要的装箱/拆箱（虽 JIT 可能优化），更掩盖了 Optional.map() 的真实意图——此处 map(val -> true) 更准确表达了“只要存在就视为 true”的业务逻辑。若真需 Boolean 对象，应直接声明目标类型：
// ✅ 清晰表达意图：需要一个可为空的 Boolean
Boolean isCalledFromActionObj = Optional.ofNullable(requestParams.get(IS_CALLED_FROM_ACTION))
.map(val -> Boolean.TRUE)
.orElse(null); // 或 Boolean.FALSE，取决于业务语义? 总结：一句话决策指南
用 true/false 赋值给 boolean 变量或参与原始类型运算；用 Boolean.TRUE/Boolean.FALSE 仅当类型系统强制要求 Boolean 对象，或需利用其 null 安全性、泛型兼容性或三态语义。
永远优先选择语义最精准、副作用最小的表达方式——不是“用类”，而是“用对的类型”。
