toMap是Stream API中将流转为Map的核心收集器，需指定key/value函数，键冲突时须提供合并策略，可自定义Map类型，但需防null值和线程安全问题。
Java 的 Stream API 中 toMap 是一个常用的收集器（Collector），用于将流中的元素按指定规则转换为 Map。它灵活但容易因键冲突或空值抛出异常，用对关键参数是核心。
基础用法：单参数键 + 单参数值
最常见场景是把对象列表转成以某个字段为 key、对象本身或某字段为 value 的映射表：
- 需要传入两个函数式参数：第一个是生成 key 的
Function，第二个是生成 value 的Function - 底层默认使用
HashMap::new创建 map，不保证顺序 - 若 key 重复，会直接抛
IllegalStateException
示例：
List<User> users = Arrays.asList(new User(1, "Alice"), new User(2, "Bob"));Map<Integer, String> idToName = users.stream()
.collect(Collectors.toMap(User::getId, User::getName));
// 结果：{1="Alice", 2="Bob"}
处理键冲突：提供合并策略
当多个元素生成相同 key 时（比如按状态分组但状态重复），必须显式传入第三个参数——BinaryOperator 合并函数：
立即学习“Java免费学习笔记（深入）”；
- 该函数接收两个 value，返回“保留哪一个”或“如何合并”
- 常用写法：
(v1, v2) -> v1（保留前者）、(v1, v2) -> v2（保留后者）、String::concat等
示例（同名用户取 ID 较小者）：
Map<String, Integer> nameToMinId = users.stream().collect(Collectors.toMap(
User::getName,
User::getId,
(id1, id2) -> Math.min(id1, id2)
));
指定 Map 类型与并发安全
第四个参数可传入 Supplier<Map>，用于自定义 map 实现：
- 想保持插入顺序？用
LinkedHashMap::new - 需要线程安全？用
ConcurrentHashMap::new（注意：仅容器线程安全，合并逻辑仍需自己保证） - 想用不可变 map？需配合
Collectors.collectingAndThen二次封装
示例（有序 map）：
Map<Integer, User> orderedById = users.stream().collect(Collectors.toMap(
User::getId,
Function.identity(),
(u1, u2) -> u1,
LinkedHashMap::new
));
注意事项与避坑点
toMap 表面简单，实际几个细节常导致运行时报错：
- key 或 value 为 null 会抛 NullPointerException：确保映射函数不返回 null，或提前 filter 掉空值
- 流为空时返回空 map：无需额外判空，但要注意 supplier 是否支持空构造
- 不要在 lambda 中修改外部变量：比如在 key 函数里 ++i 计数，会破坏函数式语义且结果不可预测
- 如果只是分组（一对多），优先用
Collectors.groupingBy，而非硬套toMap
不复杂但容易忽略。
