retainall原地修改调用方集合,仅保留与参数集合共有的元素,返回是否发生删减的boolean值;行为取决于集合实现类,不保证去重或线程安全。

retainAll 方法到底做了什么
retainAll 不是求交集的“安全封装”,而是**原地修改调用方集合,只保留它和参数集合都存在的元素**。它返回 boolean:只要集合内容被删减过(哪怕只删一个),就返回 true;完全没变或参数为空,返回 false。
关键点在于:它不创建新集合,也不保证顺序或去重——行为完全取决于调用方集合的具体实现类(ArrayList、HashSet、LinkedHashSet 等)。
ArrayList.retainAll 的实际表现
对 ArrayList 调用 retainAll 时,内部会遍历自身,逐个检查元素是否在参数集合中存在(通过 contains 判断)。这意味着:
- 参数集合最好用
HashSet或LinkedHashSet,否则contains可能是 O(n) 复杂度,整体变成 O(m×n) - 原
ArrayList的插入顺序会被保留,但重复元素(如果原本就有)也会被一并保留——retainAll不做去重 - 如果参数集合是
null,直接抛NullPointerException
示例:
立即学习“Java免费学习笔记(深入)”;
ArrayList<String> list = new ArrayList<>(Arrays.asList("a", "b", "c", "b"));
HashSet<String> others = new HashSet<>(Arrays.asList("b", "c", "d"));
list.retainAll(others); // 结果:["b", "c", "b"] —— 顺序保留,重复未清理
retainAll 和手动遍历 removeAll 的区别
有人误以为 retainAll 就是“取交集”,于是拿它替代 removeAll 做差集,结果出错。二者语义相反:
-
a.retainAll(b)→ a 变成 a ∩ b -
a.removeAll(b)→ a 变成 a − b
更隐蔽的问题是并发与迭代器失效:
- 若在增强 for 循环中调用
retainAll,会触发ConcurrentModificationException(因为底层调用了Iterator.remove) - 而
retainAll本身不是线程安全的,多线程同时操作同一集合时必须外加同步
替代方案:什么时候不该用 retainAll
如果你真正需要的是“不可变交集结果”或“去重后交集”,retainAll 就不是最佳选择:
- 要返回新集合?用
new ArrayList(a).retainAll(b)是错的——retainAll返回boolean,不是集合。正确写法是:a.stream().filter(b::contains).distinct().collect(Collectors.toList()) - 参数集合很小(比如只有 2–3 个元素),且 a 是
ArrayList,用retainAll反而比手写循环慢(因额外对象创建和方法调用开销) - 涉及自定义对象?确保
equals/hashCode正确实现,否则contains判断失效,retainAll行为不可预期
最常被忽略的一点:retainAll 依赖参数集合的 contains 实现逻辑,而该逻辑可能受 Collection 子类具体策略影响——比如 Collections.unmodifiableSet 包裹后的集合,contains 依然有效,但 retainAll 会抛 UnsupportedOperationException,因为底层无法修改原集合。










