flatMapToInt用于将字符串集合转为Unicode码点整数流，推荐用String::codePoints正确处理代理对；需过滤null，禁用chars()以防增补字符错误拆分。
在 Java 中，Stream.flatMapToInt() 是将每个元素映射为一个 IntStream 并将其“展平”成单个整数流的高效方式。若目标是把字符串集合（如 List<string></string>）转为所有字符对应的 Unicode 码点（即 int 值）组成的连续流，flatMapToInt 正是为此类场景设计的核心工具。
理解 flatMapToInt 的作用
flatMapToInt 接收一个 Function<t intstream></t>，对每个输入元素生成一个整数流，再将所有子流合并为一个统一的 IntStream。它比先 map 再手动拼接更简洁、无中间对象开销，且天然支持 Unicode 补充字符（如 emoji）——因为 String.codePoints() 返回的正是正确处理代理对（surrogate pairs）的码点流。
核心写法：用 String::codePoints
最直接、推荐的方式是使用方法引用 String::codePoints，它返回一个包含该字符串全部 Unicode 码点的 IntStream：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 示例代码：
IntStream codePointStream = strings.stream()
.flatMapToInt(String::codePoints);
这段代码会输出：72, 101, 108, 108, 111, 128188, 8205, 128187, 99, 97, 102, 233（其中 ?? 是带 ZWJ 的组合 emoji，被正确拆为三个码点）。
立即学习“Java免费学习笔记（深入）”；
注意边界情况与常见误区
-
null 字符串会导致 NullPointerException：需提前过滤或映射前判空，例如
.filter(Objects::nonNull).flatMapToInt(String::codePoints)； -
空字符串不会产生任何码点：
"".codePoints()返回空IntStream，不影响整体流连续性； -
不要用 chars() 替代 codePoints()：后者仅返回 UTF-16 代码单元（
char），对增补字符（U+10000 以上）会错误拆成两个char值，丢失语义。
后续操作建议
得到 IntStream 后可直接链式调用：
- 转数组：
codePointStream.toArray()； - 求和/统计：
codePointStream.sum()或codePointStream.count()； - 过滤特定范围：
.filter(cp -> cp >= 0x4E00 && cp （筛选中文）； - 转回字符串：
new String(codePointStream.toArray(), 0, count, java.nio.charset.StandardCharsets.UTF_8)不适用，需用String.valueOf(Character.toChars(cp))逐个构造，通常不推荐逆向。
