put(K key, V value) 是最常用存入方式,null 键存于索引 0,非 null 键经 hashCode、扰动函数及 hash & (table.length-1) 计算下标;冲突时先 == 后 equals 比较,相同则更新 value,否则尾插或树化;超阈值触发扩容;允许一个 null 键和多个 null 值,但 get(null) 无法区分键不存在与值为 null,应使用 containsKey() 判断存在性;Java 8+ 推荐用 putIfAbsent() 避免覆盖。

用 put(K key, V value) 方法存入键值对,这是最直接、最常用的方式。
基本存入操作
调用 put() 时,HashMap 会自动处理以下逻辑:
- 如果键(key)是
null,它会被固定存放在哈希表索引为 0 的位置; - 如果键非
null,先调用key.hashCode()得到哈希码,再经过扰动函数优化,最后通过hash & (table.length - 1)算出数组下标(即“桶”的位置); - 若该桶为空,直接新建节点插入;
- 若桶中已有元素,则逐个比较:先用
==判断引用是否相同,再用equals()判断逻辑相等; - 发现相同 key 就更新 value,否则链表尾插(或红黑树插入);
- 插入后若 size 超过阈值(默认容量 × 0.75),触发扩容——数组长度翻倍,所有元素重新哈希分配。
注意 null 键和 null 值的特殊行为
HashMap 允许一个 null 键和任意多个 null 值,但要注意:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
map.put(null, 10)合法,且后续map.get(null)能取到10; - 但
get()返回null时,无法区分是“键不存在”还是“键存在但值为null”; - 所以判断键是否存在,请用
containsKey(key),别依赖get(key) == null。
更安全的存入方式(Java 8+)
避免意外覆盖已有值,可用:
-
putIfAbsent(K key, V value):仅当 key 不存在时才插入; -
computeIfAbsent(K key, Function super K, ? extends V> mappingFunction):key 不存在时才计算并存入,适合按需初始化场景(如缓存)。
简单示例代码
```java
HashMap
map.put("apple", 5); // 存入新键值对
map.put("apple", 8); // 更新已有 key 的 value,返回旧值 5
map.put(null, 10); // 合法,存入 null 键
map.putIfAbsent("banana", 3); // 第一次存,生效;再调一次无效
```










