Collectors.toMap默认不保证顺序是因为使用HashMap作为底层容器，而HashMap不维护插入顺序；需显式传入LinkedHashMap::new作为mapSupplier，并确保数据源有序（如ArrayList）且提供merge function。
使用 Collectors.toMap 保持插入顺序，关键在于传入一个**可维护插入顺序的 Map 实现类**（如 LinkedHashMap）作为第三个参数，并确保流的数据源本身是有序的（如 ArrayList、Stream.of() 等）。
为什么默认 toMap 不保证顺序？
默认情况下，Collectors.toMap(keyMapper, valueMapper) 使用的是 HashMap 作为底层容器，而 HashMap 不保证迭代顺序。即使输入流是有序的，结果 Map 的遍历顺序也可能乱序。
正确写法：显式指定 LinkedHashMap
通过三参数或四参数重载版本，传入 LinkedHashMap::new 作为 mapSupplier：
示例：
List<Person> people = Arrays.asList(
new Person("Alice", 30),
new Person("Bob", 25),
new Person("Charlie", 35)
);
Map<String, Integer> nameToAge = people.stream()
.collect(Collectors.toMap(
Person::getName, // key mapper
Person::getAge, // value mapper
(v1, v2) -> v1, // merge function（处理 key 冲突）
LinkedHashMap::new // map supplier —— 这是关键！
));
此时 nameToAge 的迭代顺序与 people 列表中元素的原始顺序一致。
注意事项和常见陷阱
-
数据源必须有序：若用
Set或并行流（parallelStream()），即使用了LinkedHashMap，也不能保证“插入顺序”符合业务预期，因为并行流会打乱处理顺序。 -
merge function 不可省略：当使用带
mapSupplier的重载时，必须提供 merge function（即使逻辑是“保留第一个”），否则编译不通过。 - 避免用 HashMap::new：虽然语法合法，但会失去顺序保障，和默认行为无异。
-
key 不能重复：如果映射过程中出现重复 key 且 merge function 未妥善处理，会抛出
IllegalStateException。
替代方案：先转为 List 再构建（更可控）
若逻辑复杂或需额外校验，可分两步：
- 先用
stream().map(...).collect(Collectors.toList())得到有序键值对列表； - 再遍历该列表，逐个放入新创建的
LinkedHashMap。
这种方式语义清晰、调试友好，适合对顺序敏感且逻辑较重的场景。
