如何在 Java 中使用 Collections.frequency() 统计某个元素在集合中出现的总次数

Collections.frequency() 返回 0 的最常见原因是元素的 equals() 和 hashCode() 行为不一致或类型不匹配，比如用 Integer 查 Long、自定义类未重写 equals()；它适用于所有实现 Collection 接口的集合，但不支持数组和 Map，频繁多元素统计应改用 Map 预处理。

为什么 Collections.frequency() 返回 0 即使元素明明存在

最常见的原因是集合中元素的 equals() 和 hashCode() 行为不一致，或者传入了不同类型的对象。举个例子：你用 new Integer(1) 去查一个 Long 类型的 1L——数值上看着相等，但 equals() 直接返回 false，因为类型不同。再比如自定义类没重写 equals()，那比较结果永远为 false，哪怕两个对象内容一模一样。

那么，怎么避免掉进这个坑？三个实操建议：

• 确认目标元素与集合中元素是同一类型。尤其注意 int vs Integer vs Long 之间的“隐形”差异。
• 对自定义类，必须重写 equals()（不强制重写 hashCode()，但最好一起写上，否则可能引发其他问题）。
• 别用 null 作为目标元素去查询非 null 安全集合。像 ArrayList 允许 null，但某些包装集合可能会抛异常。

Collections.frequency() 能用在哪些集合上

这个方法只依赖 Collection 接口的 iterator()，所以只要实现了该接口的集合都支持——ArrayList、LinkedList、HashSet、TreeSet、CopyOnWriteArrayList，甚至 Arrays.asList() 返回的列表都没问题。

不过有几个需要留意的点：

• 性能差异大：对 ArrayList 是 O(n)，对 HashSet 也是 O(n)——因为即使底层是哈希结构，它也不会加速“计数”操作，依旧要遍历所有元素逐个比对。
• 不支持数组：必须先把数组转成 List，比如 Collections.frequency(Arrays.asList(arr), target)。
• 不能直接用于 Map：虽然 Map.values() 返回 Collection，但你不能直接对 Map 本身调用。必须显式接收 values() 后再传入。

替代方案：什么时候不该用 Collections.frequency()

如果需要频繁统计多个不同元素的频次，那每次调用 Collections.frequency() 都会完整遍历集合，总时间复杂度变成 O(n × m)——性能上划不来。这时候不如一次遍历建个频次表。

具体怎么选？

• 单次查询一个元素 → 直接用 Collections.frequency(collection, target)，简单直接。
• 查多个元素 → 改用 Map 预统计：

Map freq = new HashMap<>();
for (String s : list) {
    freq.merge(s, 1, Integer::sum);
}

• Ja va 8+ 可以用流：long count = list.stream().filter(e -> Objects.equals(e, target)).count(); 语义清晰，但速度略慢于原生循环。

字符串字符频次统计的坑

别直接对 String 调用——Collections.frequency() 的第一个参数必须是 Collection，而 String 不是。有人会误写 Collections.frequency("abc", 'a')，编译直接报错。

正确做法有三种：

• 转成字符列表：Collections.frequency(Arrays.asList("abc".split("")), "a")（注意是按子串切分，不适合单字符场景）
• 更稳妥：用 chars() 流 + filter："abc".chars().filter(c -> c == 'a').count()
• 或者转为 Character 列表：

List chars = "abc".chars()
    .mapToObj(c -> (char) c)
    .collect(Collectors.toList());
Collections.frequency(chars, 'a');

说到底，Collections.frequency() 只是个便利工具函数，不是魔法——底层就是 for 循环加 equals 判断。真正影响结果的，永远是你对 equals 语义的理解和集合的实际内容。