Collectors.toMap用于将流转换为Map，需指定键值映射函数，重复键时可提供合并策略，如Collectors.toMap(User::getId, u -> u)或处理冲突的三参数版本。
在Java 8及以上版本中，Collectors.toMap 是一个非常实用的工具，用于将流（Stream）中的元素转换为 Map 结构。它常用于从集合数据快速构建键值对映射，提升代码可读性和处理效率。
基本语法与参数说明
toMap 方法有三个常见重载形式，最常用的是：
Collectors.toMap(keyMapper, valueMapper)
- keyMapper：函数式接口，指定如何从流中每个元素提取键
- valueMapper：函数式接口，指定如何从流中每个元素提取值
还有一个带冲突处理的版本：
立即学习“Java免费学习笔记（深入）”；
Collectors.toMap(keyMapper, valueMapper, mergeFunction)
- mergeFunction：当出现重复键时，决定保留哪个值
基础使用示例：对象转Map
假设有一个用户类：
huaweicloud-python-sdk-helper
下载
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
class User {
private Long id;
private String name;
// 构造方法、getter等省略
}
将 List 转为以 ID 为键、User 对象为值的 Map：
List<User> users = Arrays.asList(
new User(1L, "Alice"),
new User(2L, "Bob")
);
Map<Long, User> userMap = users.stream()
.collect(Collectors.toMap(User::getId, user -> user));
此时，userMap 的 key 是用户 ID，value 是对应的 User 实例。
处理重复键的问题
如果流中存在多个元素对应相同键，直接使用 toMap 会抛出 IllegalStateException。这时需要提供合并策略：
Map<String, Integer> result = Stream.of("a", "bb", "c", "dd")
.collect(Collectors.toMap(
s -> s, // 键：字符串本身
String::length, // 值：字符串长度
(v1, v2) -> v1 // 相同键时保留第一个值
));
这个例子中，虽然每个字符串都不同，但若出现重复字符串，就会通过第三个参数解决冲突。
高级用法：自定义键值类型
你也可以将流元素映射为任意类型的键或值。例如，统计单词长度分布：
List<String> words = Arrays.asList("java", "go", "python", "js");
Map<Integer, String> lengthToWord = words.stream()
.collect(Collectors.toMap(
String::length, // 键：单词长度
w -> w, // 值：单词
(existing, replacement) -> existing + "," + replacement // 合并相同长度的词
));
结果可能是：{4="java,js", 2="go", 6="python"}
基本上就这些。合理使用 Collectors.toMap 可以让数据转换更简洁高效，注意避免空指针和重复键问题即可。
