自动装箱与拆箱是Java 5引入的语法糖，编译期由javac插入valueOf()和xxxValue()调用，运行时依赖包装类；仅在赋值、传参等明确上下文触发，不用于数组初始化；Integer等缓存-128~127范围值，超出则新建对象；null拆箱抛NPE，需判空或用Optional；避免循环中高频装拆。

自动装箱与拆箱是 Java 5 引入的重要语法糖，本质是编译器在编译期自动插入包装类与基本类型之间的转换代码，运行时仍依赖包装类的 valueOf() 和 xxxValue() 方法。

核心机制：编译器帮你写，JVM 执行它

自动装箱（如 Integer i = 100;）会被编译成 Integer.valueOf(100)；自动拆箱（如 int j = i;）则转为 i.intValue()。这不是运行时“智能识别”，而是 javac 在编译阶段就完成的静态替换。

• 所有 8 种基本类型都有对应包装类（Boolean、Byte、Character、Short、Integer、Long、Float、Double）
• 只有赋值、方法传参、返回值、表达式运算等上下文明确时才会触发，比如 list.add(42)（泛型要求 Object，自动装箱为 Integer）
• 不会发生在数组初始化或 new 表达式中：new Integer(42) 是显式创建，不走自动装箱

缓存陷阱：Integer 等只缓存小整数，别用 == 比内容

valueOf() 方法对 -128 到 127（含）范围内的 Integer、Short、Byte、Character 和 Boolean 有缓存优化，超出范围则每次新建对象。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• Integer a = 100, b = 100; → a == b 为 true（同引用）
• Integer c = 200, d = 200; → c == d 为 false（不同对象）
• 永远用 equals() 比较值，或先拆箱再用 ==（如 c.equals(d) 或 c == d.intValue()）

空指针风险：拆箱遇到 null 就抛 NullPointerException

这是高频坑点。只要包装类引用为 null，任何拆箱操作都会立即崩溃。

• Integer x = null; int y = x; → 直接抛 NPE
• 常见于数据库查询结果为 null、Map.get() 未命中、JSON 反序列化字段缺失等场景
• 防御写法：判空后再拆箱（if (x != null) y = x;），或用 Optional，或改用基本类型默认值（如 Objects.requireNonNullElse(x, 0)）

性能与设计建议：少用、慎用、懂原理

• 集合、泛型、反射、注解参数等必须引用类型的地方，装箱不可避免，但避免在循环内高频装拆（如 for (int i = 0; i ）
• 优先使用原始类型做计算，包装类型仅用于“需要对象语义”的场合（如 null 表达缺失、作为 Map 键、参与泛型）
• 自定义工具方法时，参数/返回值类型尽量保持一致：要么全用 int/Integer，别混用；若需支持 null，明确用 Integer 并文档说明

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南