keyset() 返回的是 set,不是 list 或数组,不保证顺序(除非使用 linkedhashmap 或 treemap),不可下标访问,强转为 list 会抛 classcastexception。

keySet() 返回的是 Set 还是 List?
keySet() 方法返回的是一个 Set,不是 List,更不是数组。这意味着它天然不保证顺序(除非你用的是 LinkedHashMap 或 TreeMap),且不允许重复键——这正好符合 Map 的语义。直接对返回值调用 get(0) 或尝试下标访问会编译失败,因为 Set 没有 get(int) 方法。
常见错误现象:java.lang.ClassCastException: java.util.HashMap$KeyIterator cannot be cast to java.util.List —— 有人试图把 keySet() 强转成 List 后再操作,这是错的。
- 要用遍历,就走标准集合遍历路径:增强 for、迭代器或 Stream
- 真需要索引访问?先转成
ArrayList:new ArrayList(map.keySet()),但注意这会产生额外对象和复制开销 -
TreeMap的keySet()是有序的(自然序或自定义比较器);LinkedHashMap的是插入序;HashMap的是不确定的
用增强 for 遍历 keySet 最简洁
这是最常用也最安全的方式,代码清晰、无空指针风险(前提是 map 本身非 null),且 JVM 对其做了充分优化。
Map<string integer> map = new HashMap();
map.put("a", 1);
map.put("b", 2);
for (String key : map.keySet()) {
System.out.println(key + " → " + map.get(key));
}</string>
注意点:
- 不要在循环体内调用
map.remove(key),否则抛ConcurrentModificationException - 如果只是想检查某个键是否存在,直接用
map.containsKey(key),别先取keySet()再遍历查找 - 如果后续还要频繁查 value,建议直接遍历
entrySet(),避免重复哈希查找——map.get(key)在大 Map 中可能成为性能瓶颈
用迭代器遍历时如何安全删除键
当需要根据条件删掉某些键时,必须用迭代器的 remove() 方法,不能用 map.remove()。
Iterator<string> iter = map.keySet().iterator();
while (iter.hasNext()) {
String key = iter.next();
if (key.startsWith("temp")) {
iter.remove(); // ✅ 安全
// map.remove(key); // ❌ 会触发 ConcurrentModificationException
}
}</string>
原因:keySet() 返回的是 Map 的“视图”,它的迭代器与底层 Map 共享结构状态。只有迭代器自己的 remove() 会同步更新内部 modCount。
- 用
removeIf()更简练:map.keySet().removeIf(key -> key.startsWith("temp")) - 该方法内部也是基于迭代器实现,语义明确且线程不安全(同原始 Map)
- 别对
keySet()调用stream().forEach(...)并在里面删 key,同样会出错
Stream 遍历 keySet 的适用场景和坑
适合做函数式转换、过滤、收集,比如提取所有以某前缀开头的键并转成小写列表:
List<string> filteredKeys = map.keySet().stream()
.filter(k -> k.startsWith("A"))
.map(String::toLowerCase)
.collect(Collectors.toList());</string>
但要注意:
- 每次调用
keySet().stream()都会新建一个 Stream,不会复用;频繁调用要考虑是否真需要 Stream 抽象 - Stream 不是为修改设计的,
forEach(System.out::println)可以,但forEach(map::remove)会报错(非并发安全的修改) - 如果 map 很大,
keySet()本身不占额外内存(它是视图),但stream().collect(...)会生成新集合,注意 GC 压力
复杂点在于:keySet 视图的生命周期完全绑定原 Map,一旦 map 被清空或重建,旧的 keySet 引用就变成“空壳”,但不会立即失效——它仍可遍历,只是返回空结果。这点容易被忽略。










