ArrayDeque.removeFirstOccurrence()仅移除队列中第一个匹配的指定元素，返回true或false；不处理重复项批量清理，需配合removeIf()、循环调用或流式过滤实现全量删除。
arraydeque.removefirstoccurrence() 不能用于“清理所有重复项”，它只移除**第一次出现的指定元素**，且仅当该元素存在时返回 true；它不处理“重复项”的识别或批量清理逻辑。
它实际做什么？
这个方法是 ArrayDeque 对 Collection 接口的实现之一，语义和 ArrayList.remove(Object) 类似：
- 从队头开始遍历，找到第一个
equals()为true的元素； - 将其移除（内部会移动后续元素，保持连续）；
- 成功则返回
true，未找到则返回false； - 它不关心该元素是否“重复”，也不影响其他相同值的元素。
想清理“所有重复项”？得自己加逻辑
比如你有一个 ArrayDeque<String>：["a", "b", "a", "c", "a"]，想删掉所有 "a" —— removeFirstOccurrence("a") 只会删掉第一个，剩下 ["b", "a", "c", "a"]。
正确做法是结合其他手段：
-
方案一：用 while 循环反复调用（适合少量重复）
while (deque.removeFirstOccurrence("a")) {} // 持续删直到没有 -
方案二：转成 ArrayList 或流式处理（推荐，更清晰）
deque.removeIf("a"::equals); // 直接删所有匹配项 -
方案三：重建队列（适合需保留顺序且逻辑复杂时）
ArrayDeque<String> cleaned = new ArrayDeque<>(deque.stream().filter(s -> !"a".equals(s)).toList());
注意 removeFirstOccurrence() 的限制
- 时间复杂度是 O(n)，因为要遍历查找；
- 对
null值也支持（removeFirstOccurrence(null)查找第一个null）； - 如果元素类型没重写
equals()，默认用引用比较，可能不符合预期。
小结
别指望 removeFirstOccurrence() 自动处理“重复清理”。它只是一个单次、单目标、从前向后的精确删除工具。真正要清理重复，得靠 removeIf()、循环调用、或流式过滤 —— 它只是拼图中的一小块，不是解决方案本身。
