Java HashMap merge() 方法（超详细）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

一、前言

在 Java 开发中，HashMap 是一个高频使用的数据结构，而 merge() 方法作为其核心功能之一，常被用于高效处理键值对的更新逻辑。对于编程初学者和中级开发者而言，理解 merge() 方法不仅能提升代码编写效率，还能避免许多因逻辑复杂导致的 Bug。本文将通过循序渐进的方式，结合实际案例，深入剖析 merge() 方法的原理、使用场景及进阶技巧。

二、HashMap 的基本概念与 merge() 方法的定位

2.1 什么是 HashMap？

HashMap 是 Java 集合框架中的一个哈希表实现，它通过键（Key）与值（Value）的映射关系存储数据。其核心特性包括：

• 键唯一性：同一 HashMap 中不能存在重复的键。
• 无序性：元素的存储顺序与插入顺序无关。
• 允许 null 值：可以存储 null 作为值，但键只能有一个 null。

2.2 merge() 方法在 HashMap 中的角色

merge() 方法是 HashMap（以及 Map 接口）中用于 原子性更新键值对 的方法。它的核心功能是：

1. 如果键不存在，则插入键并赋值；
2. 如果键已存在，则根据用户提供的 合并函数（BiFunction）对旧值和新值进行计算，并将结果作为新值。

这一特性使其在统计、计数、动态更新等场景中极为实用，例如：

• 统计单词出现的频率；
• 根据用户行为更新计分系统；
• 合并两个 HashMap 的值。

三、merge() 方法的语法与参数详解

3.1 方法签名

V merge(  
    K key,  
    V value,  
    BiFunction<? super V, ? super V, ? extends V> remappingFunction  
)

3.2 参数解析

1. key：需要操作的键。
2. value：当键不存在时，作为初始值插入。
3. remappingFunction：一个双参数函数，用于合并旧值（existingValue）和新值（newValue）。

3.2.1 关键点：remappingFunction 的作用

remappingFunction 是 merge() 方法的核心逻辑，它接受两个参数：

• existingValue：键已存在的旧值。
• value：本次调用传入的新值。

通过返回这两个值的计算结果，merge() 方法最终决定键对应的值。

3.3 返回值

• 如果键不存在，则返回传入的 value；
• 如果键存在且合并函数返回非 null 值，则返回合并后的结果；
• 如果合并函数返回 null，则删除该键值对。

四、merge() 方法的使用场景与代码示例

4.1 场景一：初始化或更新计数器

需求：统计一段文本中每个单词出现的次数。

4.1.1 传统写法（不使用 merge()）

Map<String, Integer> wordCount = new HashMap<>();  
for (String word : text.split(" ")) {  
    if (wordCount.containsKey(word)) {  
        wordCount.put(word, wordCount.get(word) + 1);  
    } else {  
        wordCount.put(word, 1);  
    }  
}  

4.1.2 使用 merge() 的优化写法

Map<String, Integer> wordCount = new HashMap<>();  
for (String word : text.split(" ")) {  
    wordCount.merge(word, 1, Integer::sum);  
}  

对比说明：

• merge() 通过 Integer::sum 直接将旧值与新值相加，省去了 if-else 判断。
• 原子性：合并操作在 HashMap 内部一次完成，避免了多线程环境下的竞态条件（但需注意 HashMap 本身是非线程安全的）。

4.2 场景二：动态更新用户积分系统

需求：根据用户行为（如签到、完成任务）动态增减积分。

Map<String, Integer> userScores = new HashMap<>();  

// 签到操作：默认增加 10 分  
userScores.merge("user123", 10, (oldScore, newScore) -> oldScore + newScore);  

// 任务完成：根据任务难度动态加分  
int taskBonus = calculateTaskBonus();  
userScores.merge("user123", taskBonus, Integer::sum);  

关键点：

• 通过自定义合并函数，可以灵活控制积分的增减逻辑。
• 若用户不存在（如新用户），merge() 会直接插入初始值（如 10）。

五、merge() 方法的进阶技巧与注意事项

5.1 合并函数的常见模式

5.1.1 累加（Sum）

map.merge(key, valueToAdd, Integer::sum);  

5.1.2 取最大值或最小值

// 取最大值  
map.merge(key, newValue, Math::max);  

// 取最小值  
map.merge(key, newValue, Math::min);  

5.1.3 自定义逻辑（如字符串拼接）

map.merge("key", "newPart", (oldVal, newVal) -> oldVal + newVal);  

5.2 处理 null 值的注意事项

• value 参数为 null：当键不存在时，merge() 会将 null 直接插入。
• remappingFunction 返回 null：会导致键值对被删除。
• 旧值可能为 null：需在合并函数中处理 null 的情况，例如：

  (oldVal, newVal) -> (oldVal == null ? 0 : oldVal) + newVal  
  

5.3 线程安全性与性能优化

• 非线程安全：HashMap 的 merge() 方法在单线程中是原子的，但在多线程环境下需配合 ConcurrentHashMap 使用。
• 避免频繁调用：合并函数的逻辑应尽量简洁，避免在 merge() 内部执行耗时操作。

六、merge() 与类似方法的对比

6.1 merge() vs compute()

示例对比：

// merge()  
map.merge(key, 1, Integer::sum);  

// compute()  
map.compute(key, (k, v) -> (v == null) ? 1 : v + 1);  

6.2 merge() vs putIfAbsent()

putIfAbsent() 是 merge() 的简化版，仅在键不存在时插入值，而 merge() 可以同时处理存在和不存在的情况。

七、常见问题与解决方案

7.1 问题：合并函数返回 null 会导致键被删除？

是的。根据 merge() 的定义，若合并函数返回 null，则键值对会被移除。例如：

map.merge(key, 10, (old, newV) -> old == newV ? null : old + newV);  

当 old == newV 时，键会被删除。

7.2 问题：如何避免合并函数中的 NPE（空指针异常）？

在合并函数中显式处理 null 值，例如：

(oldVal, newVal) -> (oldVal != null ? oldVal : 0) + (newVal != null ? newVal : 0)  

八、结论

通过本文的解析，读者应已掌握 Java HashMap merge() 方法的核心逻辑、使用场景及常见问题的解决方案。无论是统计计数、动态更新，还是复杂业务逻辑的整合，merge() 都能提供简洁高效的实现方式。建议开发者在实际项目中多加实践，结合具体需求选择 merge()、compute() 等方法，以提升代码的可读性和性能。

最后提醒：在多线程环境下，务必使用 ConcurrentHashMap 替代普通 HashMap，以确保线程安全。

通过本文的深入解析，希望读者能够熟练掌握这一强大工具，为 Java 开发之路增添一份信心与技巧。