Collectors.averagingInt() 可在一次遍历中计算整型流平均值并返回 double,需配合 mapToInt() 使用,空流返回 Double.NaN,内部用 long 累加防 int 溢出,比手动两次遍历更高效安全。

在 Java 中,Collectors.averagingInt() 可以直接对 Stream<integer></integer> 或其他支持映射为 int 的流,在一次遍历中算出平均值(返回 double),无需手动求和再除以数量,简洁且高效。
确保数据源能映射为 int 类型
该收集器只接受 ToIntFunction,所以原始流元素必须能通过 mapToInt() 转成 int。常见适用场景:
- 流本身是
Stream<integer></integer>:直接用mapToInt(Integer::intValue) - 流是自定义对象:用
mapToInt(obj -> obj.getScore())提取整型字段 - 避免使用
mapToInt(String::length)等可能隐含空指针或装箱开销的操作,提前校验
调用方式要写在 collect() 内部
不能单独调用 averagingInt(),它必须作为 collect() 的参数。典型写法:
double avg = list.stream().mapToInt(Integer::intValue).collect(Collectors.averagingInt(i -> i));
立即学习“Java免费学习笔记(深入)”;
更常见的简化写法(因 i -> i 是恒等函数):
double avg = list.stream().mapToInt(Integer::intValue).collect(Collectors.averagingInt(i -> i));
或者直接:
double avg = list.stream().mapToInt(Integer::intValue).collect(Collectors.averagingInt(Function.identity()));
注意空流会返回 Double.NaN
如果输入流为空,averagingInt() 返回 Double.NaN,不是 0 或异常。生产环境建议检查:
- 用
Double.isNaN(avg)判断是否无数据 - 可配合
Optional封装:先stream.findFirst()判空,再计算 - 若业务要求空时返回 0,可写成
Double.isNaN(avg) ? 0.0 : avg
性能与替代方案对比
相比手动 reduce 求和再除长度,averagingInt() 在底层做了单次遍历 + 精度优化,更适合多数场景:
- 它内部使用
long累加和,避免int溢出(但极端大数据量仍需留意) - 比先
mapToInt().sum()再除count()更安全——后者会触发两次遍历,对非集合流(如 I/O 流、生成流)不可行 - 若还需标准差、最大最小值等,考虑用
Collectors.summarizingInt()一次性获取全部统计值


















