Java Stream API的toMap收集器可将对象集合转为Map，但需注意键冲突、空值和类型匹配；基础用法指定key和value提取函数，键重复时需提供合并策略，支持自定义Map实现类与null安全处理，必要时可用groupingBy替代。
Java Stream API 的 toMap 收集器能把对象集合快速转成 Map，但要注意键冲突、空值和类型匹配问题。
基础用法：指定 key 和 value 的提取方式
最常用的是传入两个函数：一个取 key，一个取 value。比如把 User 列表按 ID 转为 Map<Long, String>：
Collectors.toMap(User::getId, User::getName)- key 是
getId()返回的Long，value 是getName()返回的String - 要求 key 值不能重复，否则会抛
IllegalStateException
处理键冲突：提供合并策略
当多个对象生成相同 key 时，必须显式指定如何合并 value。例如保留后出现的 name：
Collectors.toMap(User::getId, User::getName, (oldVal, newVal) -> newVal)- 第三个参数是
BinaryOperator<V>，决定冲突时留哪个值 - 也可写成
(a, b) -> a保留第一个，或自定义逻辑如拼接：(a, b) -> a + "," + b
指定 Map 实现类和 null 安全处理
默认返回 HashMap，但可通过四参数重载指定类型；同时要避免 key 或 value 为 null：
立即学习“Java免费学习笔记（深入）”；
- 用四参数版本：
toMap(keyMapper, valueMapper, mergeFn, HashMap::new) - 如果 source 中可能有 null key/value，提前过滤：
filter(u -> u.getId() != null && u.getName() != null) - 或用
Objects.requireNonNull在 mapper 中校验，避免运行时 NPE
替代方案：用 groupingBy 简化单值分组场景
如果只是按某个字段分组（比如所有同 ID 的用户归一组），groupingBy 更直观：
Collectors.groupingBy(User::getId, Collectors.toList())- 生成
Map<Long, List<User>>，天然支持重复 key - 不需要手动写合并逻辑，适合“一对多”映射
toMap 强大但对数据质量敏感，用之前确认 key 唯一性，冲突时明确合并规则，必要时换 groupingBy 更稳妥。
