Java Stream API中映射核心函数是map（一对一转换）和flatMap（一对多展开）；map将每个元素转为一个新元素，输出数量不变；flatMap将每个元素映射为Stream并摊平，适合解包嵌套结构。
Java Stream API 中处理集合元素映射的核心函数是 map 和 flatMap，它们都属于中间操作，用于将流中的元素转换为其他形式，但适用场景和行为有本质区别。
map：一对一转换，最常用的基础映射
map 接收一个 Function<T, R>，对每个元素执行一次转换，输出与输入元素数量一致的新流。
- 适合“一个变一个”场景：如字符串转长度、对象取字段、数值做平方等
- 返回类型可以不同，但结构不变 —— 输入 5 个元素，输出仍是 5 个元素
- 示例：
list.stream().map(String::length).collect(Collectors.toList())把字符串列表转为长度列表 - 注意：若函数返回 null，不会报错，但后续操作（如 collect）可能触发 NullPointerException
flatMap：一对多展开，处理嵌套结构的关键
flatMap 也接收一个函数，但该函数必须返回一个 Stream<R>；它会把每个元素映射出的流“摊平”成单层流。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 适合“一个变多个”或“解包嵌套”场景：如拆分字符串为字符、展开 List<List<T>>、处理 Optional
- 典型用法：
stream.flatMap(list -> list.stream())或stream.flatMap(str -> Arrays.stream(str.split(" "))) - 示例：把
List<List<Integer>> nested = Arrays.asList(Arrays.asList(1,2), Arrays.asList(3))转为[1, 2, 3]，用nested.stream().flatMap(Collection::stream).collect(...) - 与 map 混用常见：先 map 得到 Stream<Stream<T>>，再 flatMap 合并 —— 但 flatMap 一步到位更简洁
映射后通常需要收集结果
map 和 flatMap 本身不产生最终数据，必须配合终端操作（尤其是 collect）才能落地。
立即学习“Java免费学习笔记（深入）”；
- 转回集合：
.collect(Collectors.toList())、.collect(Collectors.toSet()) - 转为 Map：
.collect(Collectors.toMap(User::getId, User::getName))（注意 key 冲突会抛异常） - 拼接字符串：
.map(Object::toString).collect(Collectors.joining(", ")) - 避免只调用 map 就结束 —— 那样流不会执行，什么也不会发生
常见陷阱与建议
实际写映射逻辑时，几个细节容易影响正确性：
- map 中的 lambda 不应有副作用（比如修改外部变量或打印），它只负责转换
- flatMap 的函数不能返回 null 的 Stream，否则会抛 NullPointerException
- 如果映射后想过滤空值，可在 map 后接
filter(Objects::nonNull)，而不是在 map 内判空返回 null - 性能上，map 是轻量转换；flatMap 因涉及流创建与合并，开销略大，非必要不滥用
