本文介绍使用 java 8 stream api 快速提取两个 map 中键名交集的简洁方法，通过 `keyset()`、`filter()` 和 `containskey()` 实现零循环、高可读性的键匹配逻辑。
在实际开发中，经常需要比对两个 Map 结构，找出它们共有的键（key），例如用于数据校验、缓存同步或配置合并等场景。Java 8 提供了强大的 Stream API，使此类操作变得简洁而函数式。
以下是一个典型示例：
假设有两个 Map
Map<String, Integer> map1 = Map.of("abc", 123, "def", 234, "jkl", 567);
Map<String, Integer> map2 = Map.of("abc", 123, "def", 234, "jddj", 567);目标是获取同时存在于 map1 和 map2 中的所有键 —— 即 {"abc", "def"}。
✅ 推荐写法（一行流式表达）：
import static java.util.stream.Collectors.toSet;
Set<String> commonKeys = map1.keySet()
.stream()
.filter(map2::containsKey) // 判断该键是否也存在于 map2 中
.collect(toSet());? 原理说明：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- map1.keySet() 获取第一个 Map 的所有键的 Set 视图；
- .stream() 转为流便于函数式处理；
- .filter(map2::containsKey) 等价于 key -> map2.containsKey(key)，高效判断键是否存在（平均时间复杂度 O(1)）；
- .collect(toSet()) 收集结果为不可变 Set（如需有序结果，可用 Collectors.toList() 或 TreeSet::new）。
⚠️ 注意事项：
- 此方法只比对键（key）是否相同，不校验值（value）是否一致。若需键值完全匹配，应改用 entrySet() 并配合 filter(e -> map2.equals(e)) 或更精确的比较逻辑；
- 若 map2 为 null，调用 map2::containsKey 将抛出 NullPointerException，建议提前判空；
- 对于超大 Map，keySet().stream() 仍为内存友好方式（不复制键集合，仅迭代视图）；
- 使用 Map.of(...) 创建不可变 Map 适用于演示；生产环境请确保 Map 可修改或选用 HashMap/LinkedHashMap 等。
✅ 扩展：若需返回 List 并保持 map1 中原始插入顺序，可改用：
List<String> orderedCommonKeys = map1.keySet().stream()
.filter(map2::containsKey)
.toList(); // Java 16+，或 collect(Collectors.toList())总之，利用 Stream 链式调用，既避免了传统 for-loop 的冗余代码，又提升了逻辑清晰度与可维护性 —— 这正是 Java 8 函数式编程的核心优势。
