核心是切断隐式转换出错路径,重点防范空值拆箱、错误比较(禁用==)、集合键类型不一致及数值运算中null参与,须用objects.equals()、integer.compare()、显式判空等明确写法替代直觉依赖。

避免Java基本类型与包装类隐式转换带来的Bug,核心不是禁用自动装箱拆箱,而是切断“不知不觉就出错”的路径——重点盯住空值、比较逻辑、集合键值、数值运算这四个高发区,用明确写法代替直觉依赖。
拆箱前必须判空,尤其在条件和运算中
Integer、Long等包装类为null时参与==、>、三元表达式或算术运算,会触发隐式调用intValue()等方法,直接抛NullPointerException。这不是代码写错了,而是编译器悄悄帮你加了危险调用。
- 别写
if (age == 18)或total += count,其中age、count可能是null的包装类 - 改用
Objects.equals(age, 18)做相等判断 - 大小比较用
Integer.compare(age, 18) >= 0 - 三元表达式避免混用类型:不写
flag ? value : 0.0,改用flag && value != null ? value.doubleValue() : 0.0或统一用Double result = flag ? value : Double.ZERO
比较值一律用Objects.equals(),禁用==
==比较的是引用地址,不是数值。Integer在-128~127范围有缓存,看似能比对成功,但超出范围就失效;更糟的是,new Integer(100) == 100也返回false(因为右边100自动装箱为缓存对象,左边是新对象)。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 永远不用
==比较两个包装类变量的值 - 用
Objects.equals(a, b)替代a.equals(b),它内部已处理a或b为null的情况 - 如果必须用
equals(),确保调用方非空,或先用Optional.ofNullable(a).filter(x -> x.equals(b)).isPresent()
HashMap等集合的键必须类型一致,不混用字符串和数字
把map.put(123, "v")和map.get("123")当成一回事,是高频检索失败根源。Java不做任何隐式类型转换,"123".equals(123)恒为false。
- 业务上若ID来自HTTP参数(String)但数据库是Long,插入前统一转成String键:
map.put(String.valueOf(id), value) - 若全程用数值型键,确保所有输入都经
Long.parseLong()或Long.valueOf()校验并捕获异常 - 禁止将null作为键插入,可用
Objects.requireNonNull(id, "id cannot be null")提前拦截
性能敏感场景绕过包装类,用原始类型专用集合
循环中频繁装箱(如List<integer></integer>添加int)会生成大量短生命周期对象,加重GC压力。日志占位符传Integer也会触发装箱(SLF4J至今未优化)。
- 大数据量计算、高频循环、实时日志等场景,优先使用Eclipse Collections的
IntList、Trove的TIntArrayList - 日志输出时,直接传基本类型:
log.info("count: {}", count)(count是int),不传Integer - DTO/VO中数值字段用包装类型(保留null语义),但内部计算逻辑尽早转为基本类型,避免反复拆箱
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










