在 Java 开发中， int 和 Integer 的选择是日常编码中最基础但也最容易踩坑的决策点。这不仅仅是“基本类型”与“包装类”的区别，更是 性能、语义、面向对象设计三者之间的权衡。

结合你之前提到的“见名知义”和“代码整洁”的理念，我为你整理了这篇详细的选型指南，希望能帮你和团队建立更清晰的规范。

---

🧱 核心本质：裸数值 vs 带工具的盒子

• int：是基本数据类型。它直接存储数值，存在于栈内存（局部变量）或对象内部（成员变量），没有对象头，没有额外开销，不能为 null，默认值是 0。
• Integer：是引用数据类型（int 的包装类）。它是一个对象，存储在堆内存，包含对象头、类型指针和 int 值。可以为 null，默认值是 null。它继承了 Number 类，提供了 parseInt、toBinaryString、compareTo 等丰富的工具方法。

一句话总结： int 是为了计算效率，Integer 是为了面向对象和语义表达。

---

✅ 什么时候必须用 Integer？

在以下 4 个场景中，Integer 是不可替代的，甚至可以说是“强制要求”：

1. 集合与泛型（语法强制）

Java 的集合框架（List, Set, Map）和泛型只支持引用类型。

// ❌ 编译报错
List<int> list = new ArrayList<>(); 

// ✅ 正确写法
List<Integer> list = new ArrayList<>();

2. 需要表达“空值”语义（业务强制）

这是 Integer 最大的价值。当数据库字段、JSON 接口或业务逻辑需要区分 “0” 和 “未填写/无数据” 时，必须用 Integer。

• 场景：用户年龄字段。
  • int age = 0; → 系统无法区分是“刚出生的婴儿”还是“用户没填年龄”。
  • Integer age = null; → 明确表示“未填写”。
• POJO/DTO 设计：实体类字段强烈建议使用 Integer，以兼容数据库的 NULL 和前端的不传参。

3. 需要调用工具方法

当你需要进行进制转换、字符串解析、获取极值时，Integer 提供了静态方法：

int num = Integer.parseInt("123");
String hex = Integer.toHexString(255);
int max = Integer.MAX_VALUE;

4. 反射与注解

在通过反射获取字段类型，或者处理注解参数时，通常需要 Class 对象或对象实例，此时必须使用包装类。

---

⚡ 什么时候优先用 int？

在以下场景中，使用 int 能获得显著的性能收益和安全性：

1. 高频计算与循环计数

这是性能重灾区！ Integer 在参与运算时会触发自动装箱/拆箱，产生大量临时对象，增加 GC 压力。

// ❌ 错误示范：循环内频繁装箱
Long sum = 0L;
for (long i = 0; i < 1000000; i++) {
    sum += i; // 每次循环：拆箱 -> 加法 -> 装箱（创建新对象）
}

// ✅ 正确示范：使用基本类型
long sum = 0L;
for (long i = 0; i < 1000000; i++) {
    sum += i; // 纯 CPU 指令，无对象创建
}

2. 局部变量与临时计算

方法内部的临时变量，如果不需要 null 语义，一律用 int。

• 理由：无需堆内存分配，无 GC 负担，代码意图更明确（“这个变量一定有值”）。

3. 数组存储

int[] 在内存中是连续存储的，对 CPU 缓存极其友好，且没有对象头开销。

• 对比：Integer[] 存储的是引用，实际对象散落在堆中，遍历时容易发生 Cache Miss，且每个对象都有 16 字节左右的对象头开销。

4. switch 表达式

Java 的 switch 语句在底层对 Integer 的支持也是通过拆箱实现的，直接用 int 语义更清晰，避免潜在的 NPE。

---

⚠️ 必须警惕的 3 个“隐形坑”

1. 空指针异常（NPE）

这是 Integer 最致命的坑。当 Integer 为 null 时，进行算术运算或赋值给 int 会触发自动拆箱，直接抛出 NullPointerException。

Integer count = null;
int total = count; // 💥 运行时崩溃！
// 底层等价于：int total = count.intValue(); 

对策：在拆箱前务必判空，或使用 OptionalInt。

2. == 比较陷阱

Integer 是对象，== 比较的是内存地址，不是值！

Integer a = 127;
Integer b = 127;
System.out.println(a == b); // true  (缓存池复用)

Integer c = 128;
Integer d = 128;
System.out.println(c == d); // false (超出 -128~127 缓存范围，新建对象)

对策：比较 Integer 的值，永远使用 .equals() 或先拆箱。

3. 缓存池机制

Integer.valueOf() 默认缓存 -128 到 127 之间的对象。

• 好处：小数值频繁使用时节省内存。
• 坏处：容易让开发者产生“== 比较没问题”的错觉，一旦数值超出范围，线上就会出 Bug。

---

📊 决策速查表

场景	推荐类型	核心理由
POJO/DTO 字段	Integer	兼容数据库 NULL，区分“0”与“未填”
集合/泛型参数	Integer	语法强制要求
循环计数器/索引	int	避免装箱开销，性能优先
数学公式/高频计算	int	纯栈操作，无 GC 压力
局部临时变量	int	语义明确，无 NPE 风险
数组存储	int[]	内存连续，缓存友好，无对象头
接口返回/JSON	Integer	前端需区分“0”和“null”
数据库非空字段	int	业务保证非空，用 int 更安全

---

💡 最后的建议

1. 默认用 int：除非你有明确的理由（如需要 null、需要泛型），否则优先使用 int。这是性能和安全性的底线。
2. POJO 用 Integer：这是 Java 企业级开发的潜规则，为了 ORM 框架和 JSON 序列化的兼容性，不要在这里省那点内存。
3. 禁止 == 比较包装类：在 Code Review 中，看到 Integer == Integer 直接打回，这是低级错误。
4. 警惕自动拆箱：在调用 list.get(index) 赋值给 int 时，脑子里要有一根弦：“这个值可能是 null 吗？”

代码是写给人看的，顺便给机器执行。 选择 int 还是 Integer，本质上是在选择**“我要表达什么语义”以及“我愿意承担什么风险”**。希望这篇总结能帮你写出更健壮、更优雅的 Java 代码！ 🚀