规范自动装箱与拆箱的核心是明确控制时机，禁用==比较包装类、避免null拆箱、统一基本类型入参和语义化出参，并前置空值检查。
规范自动装箱与拆箱的核心不是禁用它，而是明确“何时让编译器代劳”，“何时必须显式控制”。统一团队代码的关键在于减少隐式行为带来的不确定性，尤其避免 == 误判、null 空指针、性能损耗这三类高频问题。
明确禁止隐式比较包装类引用
用 == 比较两个 Integer、Boolean 等包装类变量，极易因缓存机制（如 [-128, 127]）导致结果不可预测。
- ❌ 禁止写法：
if (a == b)（其中a、b是Integer类型） - ✅ 统一要求：
if (Objects.equals(a, b))或if (a != null && a.equals(b)) - ✅ 对布尔值统一用
Boolean.TRUE.equals(flag)，不依赖flag == true
集合操作中允许自动装箱，但禁止在循环内频繁拆箱运算
向 List 添加 int 值（如 list.add(i)）是合理且推荐的——这是自动装箱最自然的场景。但反向操作需谨慎：
- ✅ 允许：
for (int x : list) { ... }（增强 for 自动拆箱，语义清晰） - ⚠️ 警告：
int sum = list.stream().mapToInt(x -> x).sum();——x -> x是自动拆箱，没问题 - ❌ 禁止：
list.forEach(x -> process(x + 1));中若x可能为null，会触发NullPointerException - ✅ 替代：
list.stream().filter(Objects::nonNull).mapToInt(x -> x).forEach(...)
方法参数与返回值类型保持语义一致
不要为了“省一个 valueOf”而让接口暴露包装类细节。团队应约定：
- 入参优先使用基本类型：如
void updateAge(int age)，而非void updateAge(Integer age) - 出参按业务含义选择：返回“可能不存在”时用
Optional；返回“必有值”时用int；仅当需要区分“0”和“未设置”时才考虑Integer - 数据库映射层（如 MyBatis）可接受
Integer，但 Service 层方法签名应主动解包或校验
空值检查必须前置，不依赖自动拆箱兜底
自动拆箱遇到 null 包装类会直接抛 NullPointerException，这不是防御性编程。
- ❌ 危险写法：
int value = optionalInt.get();（optionalInt是Optional，但get()可能为null） - ✅ 规范写法：
int value = optionalInt.orElse(0);或optionalInt.ifPresent(this::handleValue); - ✅ 工具方法封装：
public static int safeInt(Integer i) { return i == null ? 0 : i; }，并在团队共享工具类中统一提供
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
