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);
它返回当前 key 对应的值：如果 key 已存在，返回已有值；如果 key 不存在，则插入并返回 null（注意：value 本身为 null 时也返回 null，需结合业务判断）。
与 computeIfAbsent 的区别：适用场景不同
putIfAbsent 适合“固定值插入”，即 value 已知、无需计算；
computeIfAbsent 更适合“按需生成值”，比如初始化复杂对象或调用耗时方法：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 用 putIfAbsent：map.putIfAbsent("user1", new User("Alice")); —— 直接传入实例
- 用 computeIfAbsent：map.computeIfAbsent("user1", k -> loadUserFromDB(k)); —— 只在缺失时才调用加载逻辑
注意 null 值的语义歧义
putIfAbsent 允许 value 为 null（前提是 Map 实现支持 null 值，如 HashMap 支持，ConcurrentHashMap 不支持）；但返回值为 null 时，无法区分是“key 不存在且插入成功”，还是“key 存在且对应值为 null”。
若业务允许 null 值，且需明确判断是否插入成功，建议显式检查：
if (map.putIfAbsent(key, value) == null) {
// 插入成功（key 原本不存在）
}
并发环境下的安全性保障
在多线程场景中，putIfAbsent 是原子操作，避免了“读-改-写”竞态条件。例如：
- ConcurrentHashMap.putIfAbsent：完全线程安全，推荐用于高并发计数、缓存初始化等
- HashMap.putIfAbsent：虽有该方法，但 HashMap 本身非线程安全，不建议在并发中使用
若不确定 Map 实现类型，优先选用 ConcurrentHashMap 或 Collections.synchronizedMap 包装后的实例。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
