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

在 Java 中,Collectors.averagingInt() 可以直接对 Stream 或其他支持映射为 int 的流,在一次遍历中算出平均值(返回 double),无需手动求和再除以数量,简洁且高效。
确保数据源能映射为 int 类型
该收集器只接受 ToIntFunction,所以原始流元素必须能通过 mapToInt() 转成 int。常见适用场景:
- 流本身是
Stream:直接用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));
更常见的简化写法(因 i -> i 是恒等函数):
将后端 Java 接口文档转换为前端 TypeScript 类型定义(interface / type)。输入:飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出:包含请求参数与响应结果的 .md 文件,含完整 JSDoc 注释。触发关键词:Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
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()一次性获取全部统计值
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










