putIfAbsent 是 Java 8 引入的 Map 方法，用于键不存在时插入值，一行替代 if+put，返回 null（插入成功）或已有值；支持并发安全（如 ConcurrentHashMap），但需注意 null 值歧义及与 computeIfAbsent 的适用差异。
putIfAbsent 是 Java 8 引入的 Map 接口方法，专为“仅当 key 不存在时才插入值”这一场景设计，比手动判断 + put 更简洁、线程安全（对 ConcurrentHashMap 等并发实现尤其重要）。
核心用法：一行代码替代 if 判断
传统写法需要先检查 key 是否存在，再决定是否插入：
if (!map.containsKey(key)) {
map.put(key, value);
}
而 putIfAbsent 直接封装该逻辑：
map.putIfAbsent(key, value);</font>
</p>
<p>它返回当前 key 对应的值：如果 key 已存在，返回已有值；如果 key 不存在，则插入并返回 null（注意：value 本身为 null 时也返回 null，需结合业务判断）。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/c1c2c2ed740f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Java免费学习笔记（深入）</a>”；</p>
<H3>与 computeIfAbsent 的区别：适用场景不同</H3>
<p><strong>putIfAbsent</strong> 适合“固定值插入”，即 value 已知、无需计算；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2870" title="Gradle 9.8.0"><img
src="https://img.php.cn/upload/manual/001/431/639/6ad9ce71d8cb6379.png" alt="Gradle 9.8.0" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2870" title="Gradle 9.8.0">Gradle 9.8.0</a>
<p></p>
</div>
<a href="/xiazai/gongju/2870" title="Gradle 9.8.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<p><strong>computeIfAbsent</strong> 更适合“按需生成值”，比如初始化复杂对象或调用耗时方法：</p>
<ul>
<li>用 putIfAbsent：map.putIfAbsent("user1", new User("Alice")); —— 直接传入实例</li>
<li>用 computeIfAbsent：map.computeIfAbsent("user1", k -> loadUserFromDB(k)); —— 只在缺失时才调用加载逻辑</li>
</ul>
<H3>注意 null 值的语义歧义</H3>
<p>putIfAbsent 允许 value 为 null（前提是 Map 实现支持 null 值，如 HashMap 支持，ConcurrentHashMap 不支持）；但返回值为 null 时，无法区分是“key 不存在且插入成功”，还是“key 存在且对应值为 null”。</p>
<p>若业务允许 null 值，且需明确判断是否插入成功，建议显式检查：</p>
<font color="gray">
<pre class="brush:php;toolbar:false;">if (map.putIfAbsent(key, value) == null) {
// 插入成功（key 原本不存在）
}
并发环境下的安全性保障
在多线程场景中，putIfAbsent 是原子操作，避免了“读-改-写”竞态条件。例如：
- ConcurrentHashMap.putIfAbsent：完全线程安全，推荐用于高并发计数、缓存初始化等
- HashMap.putIfAbsent：虽有该方法，但 HashMap 本身非线程安全，不建议在并发中使用
若不确定 Map 实现类型，优先选用 ConcurrentHashMap 或 Collections.synchronizedMap 包装后的实例。
