1. 项目概述为什么合并List是Java开发者的基本功在Java的日常开发中处理集合数据是家常便饭。无论是从多个数据源聚合信息还是对数据进行分批处理后的汇总合并两个List集合的需求几乎无处不在。表面上看这只是一个简单的“相加”操作但背后却涉及到集合的底层实现、性能考量、线程安全以及代码的可读性。一个看似简单的list1.addAll(list2)在不同的场景下可能隐藏着内存溢出、数据错乱甚至并发修改异常的风险。我见过不少初级开发者在面试中被问到“如何合并两个List”时只能答出addAll一旦追问其原理、适用场景或替代方案就哑口无言了。这恰恰说明掌握这项基本功的多种实现方式及其背后的“为什么”是区分代码熟练工与思考型开发者的关键。本文将带你深入解析Java中合并两个相同类型List集合的多种方法从最基础的API调用到流式编程再到应对并发场景的考量并结合实际开发中的坑点让你不仅会“用”更懂“为何这么用”。2. 核心需求与场景拆解在深入方法之前我们必须先明确“合并两个相同的List集合”这个需求的具体内涵和典型场景。这里的“相同”通常指泛型类型相同例如都是ListString或ListUser。2.1 合并操作的几种核心诉求简单聚合将两个集合的所有元素合并到一个新的集合中不关心顺序也不去重。这是最常见、最基础的需求。例如合并上午和下午的订单列表。有序合并在合并的同时需要保持某种顺序。这可能基于元素本身的自然顺序实现Comparable接口或根据业务规则自定义排序。例如合并两个已按时间排序的日志列表合并后的列表仍需保持时间顺序。去重合并合并时自动过滤掉重复的元素。这里的“重复”可能指对象引用相同也可能指根据对象的某些字段如ID判重。例如合并来自两个系统的用户列表需要根据用户ID去重。并发安全合并当合并操作可能发生在多线程环境下时需要确保线程安全避免出现ConcurrentModificationException等异常。例如在Web应用的监听器或定时任务中合并动态变化的列表。2.2 不同场景下的方法选型考量选择哪种合并方法绝非随意而是需要权衡以下几个维度性能数据量有多大是O(n)还是O(n^2)的时间复杂度是否需要频繁扩容内存是创建新集合还是在原有集合上修改对原集合是否有影响线程安全操作环境是否是并发的原集合是否是线程安全的集合如CopyOnWriteArrayList可读性与简洁性代码是否清晰易懂符合团队规范和现代Java风格如使用Stream API功能性是否需要额外的功能如去重、过滤、排序理解这些场景和考量点我们才能为接下来的方法解析建立正确的评估框架。3. 基础API方法addAll的深入剖析List.addAll(Collection? extends E c)是java.util包下最直接、最古老的合并方法。几乎所有人第一个想到的就是它。3.1 标准用法与源码窥探ListString list1 new ArrayList(Arrays.asList(A, B, C)); ListString list2 new ArrayList(Arrays.asList(D, E, F)); // 方法1在list1末尾追加list2的所有元素 list1.addAll(list2); System.out.println(list1); // 输出[A, B, C, D, E, F] // 方法2创建新集合避免修改原集合 ListString mergedList new ArrayList(list1); mergedList.addAll(list2);为什么ArrayList的addAll通常很快我们简单看一下ArrayList.addAll的源码简化逻辑它会先计算需要扩容的大小然后一次性将传入集合的元素通过System.arraycopy()批量拷贝到底层数组的末尾。System.arraycopy是JVM层面的本地方法执行的是内存块的复制效率远高于循环调用add方法。这也是为什么在已知两个列表大小的情况下使用带初始容量的构造函数new ArrayList(list1.size() list2.size())能获得最佳性能因为它避免了中间可能发生的多次扩容。3.2 注意事项与常见陷阱注意addAll是“浅拷贝”Shallow Copy。它复制的是集合中元素的引用而非元素对象本身。如果集合中存放的是可变对象如自定义的User那么通过任何一个引用修改了对象的状态所有包含该引用的集合都会“看到”这个变化。ListStringBuilder builders1 new ArrayList(); builders1.add(new StringBuilder(Hello)); ListStringBuilder builders2 new ArrayList(); builders2.add(new StringBuilder(World)); builders1.addAll(builders2); // 此时builders1包含两个StringBuilder对象的引用 builders1.get(0).append( Java); // 修改第一个元素 System.out.println(builders1.get(0)); // 输出Hello Java // builders2中的元素对象本身没有被修改但builders1和builders2持有的是不同对象的引用所以这里不影响builders2。实操心得修改原集合直接调用list1.addAll(list2)会修改list1。如果list1是方法参数或需要保持原样务必先创建副本。空指针安全list1.addAll(list2)在list2为null时会抛出NullPointerException。稳健的代码应该先判空if (list2 ! null) list1.addAll(list2)。自我合并list1.addAll(list1)在理论上是允许的但通常没有意义且对于ArrayList会导致其容量翻倍并复制自身所有元素造成不必要的性能开销。4. 工具类方法Collections与第三方库的巧用除了直接使用集合API利用现有的工具类可以写出更简洁、功能更强大的代码。4.1 使用Collections.addAll方法java.util.Collections类提供了一个静态方法addAll(Collection? super T c, T... elements)。虽然它通常用于添加多个单独元素但结合可变参数和数组也能用于合并。ListString list1 new ArrayList(Arrays.asList(A, B)); ListString list2 Arrays.asList(C, D); // 注意这里返回的是Arrays$ArrayList固定大小 ListString mergedList new ArrayList(list1); // 将list2转换为数组然后通过Collections.addAll添加 Collections.addAll(mergedList, list2.toArray(new String[0]));为什么有时用它它的主要优势在于添加零散元素时的便利性。对于合并两个集合其内部实现最终还是循环调用add性能上通常不如ArrayList.addAll的批量拷贝。但在合并多个小集合或集合与数组混合的场景下代码可能更清晰。4.2 使用Apache Commons Lang或Guava第三方库如Apache Commons Lang的ListUtils或Google Guava的Iterables/Lists提供了更丰富的集合操作。Apache Commons LangListUtils.union:// 需要引入org.apache.commons:commons-collections4或类似依赖 // ListString union ListUtils.union(list1, list2); // 注意其union方法可能涉及去重逻辑取决于具体版本和实现使用前需查证。实际上Commons Collections 4中的ListUtils.union返回的是两个列表的视图并不直接创建一个包含所有元素的新列表修改视图会影响原列表且其迭代顺序是list1后接list2。这是一个“惰性”合并适用于只读场景。Google GuavaIterables.concat:// 需要引入com.google.guava:guava import com.google.common.collect.Iterables; import com.google.common.collect.Lists; IterableString concatenated Iterables.concat(list1, list2); // 转换为List ListString mergedList Lists.newArrayList(concatenated);Iterables.concat同样返回一个惰性的视图只有在遍历时才会依次从两个原列表中获取元素。Lists.newArrayList(Iterable)则会真正地将所有元素复制到一个新的ArrayList中。Guava的方式非常灵活可以轻松连接多个Iterable。工具类选型建议 如果你的项目已经引入了这些库使用它们可以提供更好的代码表达能力和一些高级特性如惰性求值。但如果只是为了合并列表而引入一个庞大的第三方库则显得有些重原生的addAll或Stream API通常是更轻量、更标准的选择。5. Java 8 Stream API声明式合并与高级操作Java 8引入的Stream API为集合操作带来了革命性的变化它允许你以声明式的方式处理数据。合并列表在Stream中变得异常优雅和强大。5.1 基础合并Stream.concat与Collectors.toListListString list1 Arrays.asList(A, B); ListString list2 Arrays.asList(C, D); // 使用Stream.concat连接两个流然后收集为List ListString mergedList Stream.concat(list1.stream(), list2.stream()) .collect(Collectors.toList());为什么推荐Stream API链式调用与声明式代码清晰地表达了“连接流然后收集”的意图更符合“做什么”而非“怎么做”的现代编程思想。易于扩展你可以在collect之前插入各种中间操作实现复杂的合并逻辑。5.2 高级合并去重、过滤与排序这才是Stream API在合并场景下大放异彩的地方。一行代码就能完成过去需要多行才能实现的功能。合并并去重ListString list1 Arrays.asList(A, B, C); ListString list2 Arrays.asList(C, D, A); ListString distinctMergedList Stream.concat(list1.stream(), list2.stream()) .distinct() // 去重 .collect(Collectors.toList()); // 输出[A, B, C, D]去重依据是Object.equals()方法。对于自定义对象需正确重写equals和hashCode。合并、过滤并排序ListInteger numbers1 Arrays.asList(1, 3, 5); ListInteger numbers2 Arrays.asList(2, 4, 6, 0); ListInteger processedList Stream.concat(numbers1.stream(), numbers2.stream()) .filter(n - n 0) // 过滤掉小于等于0的数 .sorted() // 自然排序 .collect(Collectors.toList()); // 输出[1, 2, 3, 4, 5, 6]合并自定义对象并按属性去重 假设有User对象需要根据id合并去重。ListUser users1 ...; ListUser users2 ...; ListUser mergedUsers Stream.concat(users1.stream(), users2.stream()) .collect(Collectors.collectingAndThen( Collectors.toMap(User::getId, Function.identity(), (u1, u2) - u1), // 按id去重保留前者 map - new ArrayList(map.values()) ));这里使用了Collectors.toMap将流元素转换为一个MapInteger, User其中键是id值是User对象。当id冲突时(u1, u2) - u1选择保留第一个出现的。最后将Map的值转换为ArrayList。Stream API实操心得性能考量Stream API会带来一定的开销创建流、调用函数接口。对于数据量极小如几十个元素的简单合并addAll可能更快。但对于需要复杂处理如过滤、映射、去重或数据量较大的场景Stream的并行流parallelStream()和内部优化往往能带来更好的可读性和可维护性性能也足够好。不可变性Stream操作不会修改源列表总是产生一个新的结果这符合函数式编程的不可变思想减少了副作用。Collectors.toList()的返回值在Java 16之前Collectors.toList()返回的List实现类是未指定的通常是ArrayList。从Java 16开始它返回一个不可变的List调用add会抛异常。如果需要可变的List可以使用Collectors.toCollection(ArrayList::new)。6. 并发场景下的合并策略当你的列表可能被多个线程访问或修改时简单的addAll或Stream操作就可能抛出ConcurrentModificationException。这时需要采用线程安全的策略。6.1 使用synchronized或显式锁最直接的方法是对合并操作加锁。ListString sharedList Collections.synchronizedList(new ArrayList()); ListString batchData getDataFromSomewhere(); synchronized(sharedList) { sharedList.addAll(batchData); }使用Collections.synchronizedList包装的列表其每个方法都是同步的。但在进行复合操作如迭代并添加时必须在外部对列表对象本身进行同步如上例所示。6.2 使用CopyOnWriteArrayListjava.util.concurrent.CopyOnWriteArrayList是专为高并发读、低并发写场景设计的线程安全列表。其核心思想是任何修改操作如add,set,addAll都会在底层创建一个新的数组副本修改在这个副本上进行完成后再原子性地替换旧的数组引用。CopyOnWriteArrayListString cowList new CopyOnWriteArrayList(Arrays.asList(A, B)); ListString newData Arrays.asList(C, D); // addAll操作是线程安全的 cowList.addAll(newData);为什么选择CopyOnWriteArrayList优点读操作get,iterator完全无锁性能极高且迭代器不会抛出ConcurrentModificationException因为它遍历的是创建迭代器时刻的数组快照。缺点写操作尤其是addAll的成本极高因为需要复制整个底层数组。仅适用于读多写少且写入数据量不大的场景。合并场景适用性如果你有一个需要被频繁遍历读取的共享列表偶尔需要合并进一批新数据并且能接受合并操作写的较高延迟那么CopyOnWriteArrayList是一个好选择。切记不要用它来存储频繁变化或巨大的列表。6.3 并发环境下的Stream合并即使在并发环境下你也可以安全地使用Stream API来合并两个已经存在的列表前提是你在合并过程中不修改源列表。ListString list1 getSafeList1(); // 假设是线程安全或不可变的列表 ListString list2 getSafeList2(); ListString merged Stream.concat(list1.stream(), list2.stream()) .collect(Collectors.toList());关键在于list1和list2的来源。如果它们来自一个线程安全的容器如从ConcurrentHashMap的值集合获取或者是在合并操作开始前就已经确定的快照那么合并过程本身是线程安全的。Stream的收集器如Collectors.toList内部使用的集合如ArrayList并非线程安全但整个收集过程发生在单个线程中除非使用并行流因此没有问题。如果使用并行流.parallelStream()则需要使用线程安全的收集器如Collectors.toConcurrentList()。7. 性能对比与选型指南了解了这么多方法我们通过一个简单的维度对比来帮助决策。方法描述优点缺点适用场景List.addAll()在原列表或新列表末尾追加原生支持性能高批量拷贝使用简单修改原集合除非新建需注意NPE功能单一最通用的简单合并场景性能敏感且无需额外处理Collections.addAll()向集合添加多个元素可添加数组或零散元素代码有时更清晰对于合并两个集合性能通常不如addAll合并小集合或集合与数组混合的场景**Stream API (concat) **连接两个流后收集声明式编程易于组合中间操作过滤、去重、映射不修改源数据有一定性能开销对于极简单操作稍显繁重需要在合并前后进行复杂数据处理的场景追求代码现代感和可读性CopyOnWriteArrayList.addAll()线程安全列表的追加读操作无锁性能极高迭代安全写操作含addAll性能极差内存消耗大高并发读、低频批量写的共享列表合并场景第三方库 (Guava)使用Iterables.concat等提供惰性视图功能丰富API设计优雅引入额外依赖项目已使用该库或需要其提供的特定高级功能选型决策流程建议是否需要线程安全是 - 考虑CopyOnWriteArrayList读多写少或使用锁/同步块保护synchronizedList的addAll操作。否 - 进入第2步。合并前后是否需要过滤、去重、映射等复杂操作是 -首选Stream API。代码清晰且功能强大。否 - 进入第3步。是否介意修改原集合是否需要保留原集合不变需要保留原集合 - 创建新集合然后使用addAll或Stream API。可以修改原集合 - 直接使用addAll。数据量级和性能要求数据量极大数十万以上且仅做简单合并 - 使用new ArrayList(initialCapacity)预分配大小后addAll性能最优。数据量一般 - 以上方法性能差异不大优先考虑代码清晰度和可维护性。8. 实战案例与避坑指南让我们通过几个真实开发中可能遇到的案例来综合运用上述知识。8.1 案例一合并分页查询结果假设你需要从两个不同的服务分页查询用户订单然后合并成一个列表进行展示。// 模拟服务调用 PageResultListOrder pageResult1 orderService.getOrdersByPage(page1, size); PageResultListOrder pageResult2 orderService.getOrdersByPage(page2, size); ListOrder ordersFromService1 pageResult1.getData(); ListOrder ordersFromService2 pageResult2.getData(); // 合并并需要按订单创建时间倒序排列 ListOrder allOrders Stream.concat( ordersFromService1.stream(), ordersFromService2.stream() ) .sorted(Comparator.comparing(Order::getCreateTime).reversed()) // 合并后排序 .collect(Collectors.toList());避坑点这里排序是在内存中进行的全量排序。如果两个分页结果本身已经有序更高效的合并方式是使用**归并排序Merge Sort**的思想但Java标准库没有直接提供。如果数据量很大合并后排序可能成为性能瓶颈。此时可以考虑让服务端返回已排序的数据或者使用PriorityQueue进行多路归并。8.2 案例二合并并去重基于业务键合并两个商品列表根据商品ID去重并优先保留第一个列表中商品的价格。ListProduct list1 ...; // 来自缓存 ListProduct list2 ...; // 来自数据库 MapLong, Product productMap new LinkedHashMap(); // 用LinkedHashMap保持某种顺序 // 先放入list1的商品 for (Product p : list1) { productMap.putIfAbsent(p.getId(), p); } // list2的商品只会放入id不重复的 for (Product p : list2) { productMap.putIfAbsent(p.getId(), p); // putIfAbsent只在key不存在时放入 } ListProduct mergedAndDistinctList new ArrayList(productMap.values());避坑点使用putIfAbsent实现了“优先保留先出现者”的逻辑。如果需要更复杂的合并策略如价格取平均值、库存相加需要在putIfAbsent或后续处理中实现自定义的合并函数。使用Stream API的toMap收集器配合合并函数merge function是更函数式的写法。8.3 案例三在Web请求中合并线程局部数据在拦截器或过滤器中你可能需要将本次请求的附加数据合并到一个线程安全的上下文列表中。public class RequestContextHolder { // 使用ThreadLocal存储属于当前线程的列表 private static final ThreadLocalCopyOnWriteArrayListString REQUEST_ATTRIBUTES ThreadLocal.withInitial(CopyOnWriteArrayList::new); public static void addAttribute(String attr) { REQUEST_ATTRIBUTES.get().add(attr); } public static ListString getAllAttributes() { return new ArrayList(REQUEST_ATTRIBUTES.get()); // 返回一个快照避免外部修改 } // 合并一批属性 public static void addAllAttributes(ListString attrs) { if (attrs ! null !attrs.isEmpty()) { REQUEST_ATTRIBUTES.get().addAll(attrs); } } }避坑点这里内部使用CopyOnWriteArrayList是因为每个线程独立一份写操作不频繁且数据量小同时能保证线程内迭代的安全。getAllAttributes()返回的是一个新的ArrayList副本这是一个好习惯防止调用者修改ThreadLocal中的原始数据造成不可预知的影响。务必在请求结束时如通过Filter的finally块调用REQUEST_ATTRIBUTES.remove()清理ThreadLocal防止内存泄漏。9. 总结与最佳实践建议经过对各种方法的拆解和场景分析我们可以提炼出一些关于Java中合并List的最佳实践明确意图与影响首先要问自己合并操作是否需要修改原列表是否需要保持原列表不变明确这一点能帮你决定是就地修改还是创建新集合。优先考虑Stream APIJava 8对于大多数现代Java项目Stream API应该是首选。它不仅代码简洁而且通过组合filter、distinct、sorted、map等操作能轻松应对复杂的合并逻辑极大地提升了代码的表达能力和可维护性。性能问题在绝大多数业务场景下都不是瓶颈。简单场景用addAll如果仅仅是两个列表的简单拼接且对原列表的修改无影响那么ArrayList的addAll是最直接、最高效的选择。记得处理null值。并发场景审慎选择区分“读多写少”和“写多”的场景。CopyOnWriteArrayList适用于前者而后者可能需要考虑ConcurrentLinkedDeque或其他并发容器或者使用细粒度锁。关注对象引用与深拷贝始终记住集合中存储的是引用。如果合并后不希望原集合中对象的修改影响到新集合或反之你需要进行深拷贝这通常意味着要遍历集合并创建新对象。Apache Commons Lang的SerializationUtils.clone()要求对象实现Serializable或手动复制构造都是可选方案但深拷贝本身是一个复杂话题。性能测试是最终标准当你在关键路径如高频调用的接口、大数据量处理上对性能有极致要求时不要盲目相信经验。编写基准测试使用JMH用真实的数据规模和硬件环境来验证不同方法的性能表现。有时候一个预分配了正确大小的ArrayList加上addAll可能就是最快的。最后合并List这个操作就像木匠手中的榫卯看似简单但不同的连接方式决定了结构的牢固、美观与效率。理解每种方法背后的原理和代价根据实际情况灵活选用才能写出既稳健又优雅的代码。