flatMapToInt适用于将流中每个元素映射为IntStream并合并为单一整数流的场景，如解析字符串列表为整数流或提取字符串长度，要求映射函数返回IntStream而非List等非流类型。
flatMapToInt 适用于什么场景
当你有一组对象，每个对象内部又包含一个 int[]、IntStream 或能转成整数流的结构（比如 List 需先映射为 IntStream），且最终目标是得到一个统一的整数序列（而非嵌套集合）时，flatMapToInt 才真正有用。它不是用来“展开任意嵌套对象”的通用扁平化工具——如果中间层是 List 或自定义对象，必须手动提供到 IntStream 的转换逻辑。
为什么不能直接 flatMapToInt(obj -> obj.intList)
常见错误是写成 stream.flatMapToInt(obj -> obj.intList)，这会编译失败，因为 flatMapToInt 接收的是 ToIntFunction super T>，返回值必须是 IntStream，而不是 List 或 int[]。正确做法是显式调用转换方法：
-
obj.intArray→ 用Arrays.stream(obj.intArray) -
obj.intList→ 用obj.intList.stream().mapToInt(Integer::intValue) -
obj.getNumbers()（返回IntStream）→ 直接返回该流
处理含 null 或空数组的健壮写法
实际数据中常有 null 字段或空数组，不加防护会导致 NullPointerException 或跳过整个元素。推荐在映射前做防御性检查：
list.stream()
.flatMapToInt(item -> {
if (item == null || item.values == null) {
return IntStream.empty();
}
return Arrays.stream(item.values);
})
.forEach(System.out::println);
注意：不要用 Optional.ofNullable(...).map(...).orElse(IntStream.empty())，因为 flatMapToInt 不接受 Optional；必须在 lambda 内部完成判空并返回 IntStream。
性能与替代方案对比
flatMapToInt 本质是惰性求值，适合链式计算（如后续接 sum()、max()），但若你最终需要 int[]，直接收集再转比流式更高效：
- 用流：
stream.flatMapToInt(...).toArray()—— 创建中间流节点，有额外开销 - 手动遍历：
IntArrayList（来自 Eclipse Collections）或预估容量的ArrayList+stream().mapToInt(...).toArray()—— 更可控
尤其当层级深、元素多，且只是做一次性扁平+转数组时，别迷信 flatMapToInt 的“函数式优雅”——它解决的是类型适配问题，不是性能银弹。
最容易被忽略的一点：flatMapToInt 只接受产生 IntStream 的函数，如果你手头是 long[] 或 double 值，它完全不适用，得换 flatMapToLong 或老实用 flatMap + mapToInt 组合。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
