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注释规范Skills
下载
当用户要求为 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); // 第一次存，生效；再调一次无效
```
