如何应用Collectors.toMap实现在转换映射时对变量Key进行统一格式化处理

使用 `Collectors.toMap` 时，如果要顺手对 key 做统一格式化（比如转小写、去空格、加前缀），直接在 `keyMapper` 里搞定就行，这才是最清爽的写法。万一遇到重复 key，记得准备一个 `mergeFunction`，不然会翻车。如果格式化逻辑太复杂，抽成工具方法，代码会好看很多。

用 Collectors.toMap 的时候，相信不少人都有过这样的需求：希望最终生成的 Map 里，key 是统一处理过的——比如全部转小写、去掉前后空格、或者加上某个固定前缀。最直接、最高效的做法，就是在 lambda 表达式的 keyMapper 里把格式化逻辑写进去，而不是先做一个普通的 Map，再单独跑一遍转换。

在 toMap 的 keyMapper 中直接格式化

这种写法非常简洁，一眼就能看懂。keyMapper 函数接收流里的每个元素，然后返回你想要的格式化后的 key 值。

• 举个简单的例子：把字符串列表转成小写 key 的 Map：

List list = Arrays.asList("Apple", "Banana", "Cherry");
Map 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"），那么 toMap 默认的行为是抛出 IllegalStateException。解决方案很简单——提供一个 mergeFunction，告诉它遇到冲突时该怎么办。

• 保留第一个出现的 value：

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

• 如果想要把这个 key 对应的所有原始 value 都收集起来，可以这样写：

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

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

操作对象流的时候，做法也是一样的，只是需要组合 getter 方法和字符串处理函数。比如下面这个例子，用 User 对象的 name 字段，去除首尾空格并转小写，作为 Map 的 key：

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

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

如果格式化规则稍微复杂一点，或者需要在多处使用，建议不要一股脑全塞进 lambda 里，那样可读性会变差。更好的做法是抽成一个静态方法或者函数式接口实例，然后在 toMap 里直接调用。

• 先定义一个工具方法：

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
))

这样即使后续格式化规则有调整，也只需要改一个地方，不会污染流处理的逻辑。