Collectors.averagingInt() 直接计算 int 字段平均值，空流或全 null 时返回 0.0；要求输入为 ToIntFunction，不支持已执行表达式，对 null 元素静默跳过，不返回 OptionalDouble。
Collectors.averagingInt() 能直接算平均值，但只适用于 int 类型字段，且遇到空流会返回 0.0 —— 这不是 bug，是设计行为，得提前防住。
averagingInt() 的输入必须是 ToIntFunction
它不接受任意表达式，只认 ToIntFunction<t></t> 类型的映射逻辑。比如你想对 List<person></person> 按年龄求平均，就得写成 Person::getAge 或 p -> p.getAge()，不能写 p.getAge() + 1 这种已执行的值。
- ✅ 正确：
stream.collect(Collectors.averagingInt(Person::getAge)) - ❌ 错误：
stream.collect(Collectors.averagingInt(p -> p.getAge() * 100))（虽然语法通过，但语义易错——它算的是放大后的平均，不是原始平均） - ⚠️ 注意：
getAge()返回Integer时，需用Objects.requireNonNull(p.getAge())或先过滤 null，否则运行时报NullPointerException
空集合或全 null 元素时返回 0.0，不是 Optional
和 Collectors.summingInt() 一样，averagingInt() 不返回 OptionalDouble，而是无条件返回 double。空流、null 元素被跳过后的空结果，统统变成 0.0 —— 这容易掩盖数据异常。
- 若业务上“无数据”和“平均为 0”含义不同，必须手动判空：
if (list.isEmpty()) throw new IllegalStateException("no data"); - 想安全处理 null 字段：先
filter(Objects::nonNull)再mapToInt(...)，或者改用collectingAndThen(averagingInt(...), d -> d == 0.0 && list.isEmpty() ? Optional.empty() : Optional.of(d)) - 注意：它内部对 null 元素静默跳过，不会报错，但也不会警告
和 mapToInt().average() 性能与语义差异
两者结果一致，但底层路径不同：averagingInt() 是终端收集器，走 Collector 协议；mapToInt().average() 返回 OptionalDouble，且强制要求流中元素非 null（否则 mapToInt 抛 NullPointerException）。
- ✅ 推荐
averagingInt()：语义更清晰（明确是“收集平均值”），且对 null 元素容忍度略高（只要映射函数不炸） - ✅ 推荐
mapToInt().average()：当你需要区分“无数据”和“平均为 0”，且能确保字段非 null - ⚠️ 别混用：
stream.mapToInt(...).boxed().collect(averagingInt(...))多余装箱，性能差
真正麻烦的不是怎么调用，而是搞清“谁该负责判空”——是上游数据清洗？映射函数里防御？还是收集后校验返回值是否为 0.0？这得看你的数据契约是否稳定。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
