使用Collectors.toMap时，应在keyMapper中直接格式化key（如转小写、去空格等），遇重复key需提供mergeFunction避免异常，复杂逻辑应封装为工具方法提升可读性。

使用 Collectors.toMap 时，若需对 key 进行统一格式化（如转小写、去空格、加前缀等），关键在于在 lambda 表达式的 key mapper 中直接完成格式化逻辑，而不是依赖外部预处理或额外 Map 步骤。

在 toMap 的 keyMapper 中直接格式化

这是最简洁、高效的方式。keyMapper 函数接收流中每个元素，返回格式化后的 key 值。

• 例如将字符串列表转为小写 key 的 Map：

List<String> list = Arrays.asList("Apple", "Banana", "Cherry");
Map<String, String> map = list.stream()
  .collect(Collectors.toMap(
    s -> s.toLowerCase(),  // 格式化 key：转小写
    s -> s                  // value 保持原样
  ));
// 结果：{"apple"="Apple", "banana"="Banana", "cherry"="Cherry"}

处理可能重复的格式化 key（避免 IllegalStateException）

当格式化后 key 可能冲突（如 "Apple" 和 "apple" 都变成 "apple"），必须提供 mergeFunction，否则会抛出异常。

• 保留第一个出现的 value：

.collect(Collectors.toMap(
  s -> s.toLowerCase(),
  s -> s,
  (v1, v2) -> v1  // 冲突时保留先出现的
))

• 拼接多个 value（适用于收集同 key 的所有原始值）：

.collect(Collectors.toMap(
  s -> s.toLowerCase(),
  s -> List.of(s),
  (list1, list2) -> Stream.concat(list1.stream(), list2.stream()).toList()
))

结合对象字段 + 格式化逻辑生成 key

对对象流操作时，可组合 getter 与字符串处理方法。

• 例如用 User 对象的 name 字段，去除首尾空格并转小写作 key：

List<User> users = ...;
Map<String, User> map = users.stream()
  .collect(Collectors.toMap(
    user -> user.getName().trim().toLowerCase(),
    Function.identity(),
    (u1, u2) -> u1
  ));

封装复用格式化逻辑（提升可读性）

若格式化规则较复杂或需多处使用，建议提取为静态方法或函数式接口实例，避免 lambda 内堆积代码。

• 定义工具方法：

private static String normalizeKey(String raw) {
  return Optional.ofNullable(raw)
    .map(String::trim)
    .filter(s -> !s.isEmpty())
    .map(String::toLowerCase)
    .orElse("unknown");
}

• 在 toMap 中调用：

.collect(Collectors.toMap(
  MyUtils::normalizeKey,
  User::getEmail,
  (e1, e2) -> e1
))