HashSet的add方法返回true表示元素首次添加，false表示元素已存在；其依据equals()和hashCode()判断重复，故自定义类需重写这两个方法；常用于去重统计和避免重复处理。

Java HashSet 的 add 方法返回 true 表示元素是新添加的，返回 false 表示该元素已存在，未重复插入。

返回值含义很直接

HashSet 不允许重复元素，它的 add(E e) 方法签名是：

public boolean add(E e)

这个布尔值不是“操作是否成功”的笼统反馈，而是明确回答：

• true：集合中**原来没有**这个元素，现在已加入；
• false：集合中**已经存在**等价元素（根据 equals() 和 hashCode() 判断），本次调用没做任何修改。

底层逻辑依赖 equals + hashCode

HashSet 判断“是否已存在”，不是靠引用比较，而是：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

立即学习“Java免费学习笔记（深入）”；

• 先用 e.hashCode() 定位桶位置；
• 再在对应桶内遍历，用 existing.equals(e) 逐个比对；
• 只要有一个返回 true，就认定重复，返回 false。

所以如果你自定义类放进 HashSet，必须正确重写 hashCode() 和 equals()，否则 add 可能错误地返回 true（实际应为 false）或反之。

常见用途：去重 + 状态判断

这个返回值常用于两类场景：

• 批量去重时统计新增数量：
  int newCount = 0;
  for (String s : list) { if (set.add(s)) newCount++; }
• 避免重复初始化或处理：
  if (visited.add(id)) { process(id); } // 只处理第一次遇到的 id

注意不是所有集合都这样设计

比如 ArrayList.add() 总是返回 true（因为总会加进去），而 LinkedHashSet 和 TreeSet 的 add 行为与 HashSet 一致——都用返回值表达“是否新增”。但 Map.put() 返回的是被替换的旧值，语义不同，别混淆。