HashSet的add()返回true表示元素首次添加成功，集合大小增加；返回false表示元素已存在，集合未改变。其本质是HashMap.put()是否插入新键的结果，用于高效去重而非错误判断。

HashSet 的 add() 方法返回值只有两种：true 或 false，区分的关键不在于“怎么认出它”，而在于“怎么理解它背后的集合状态变化”。

返回 true：元素是新的，集合被修改了

这表示你传入的元素此前不在 HashSet 中，它被成功加入，且集合大小增加 1。判断依据是该元素的 hashCode() 和 equals() 在当前集合中未匹配到任何已有元素。

• 常见于首次添加字符串、数字、或正确重写了 hashCode/equals 的自定义对象
• 即使两个对象内容相同但未重写 equals，也可能返回 true（逻辑错误，不是设计本意）
• 返回 true 意味着你可以安全触发“首次发生”的业务逻辑，比如发注册通知、初始化缓存

返回 false：元素已存在，集合没变

这不代表出错，而是 Set 的核心语义在起作用——拒绝重复。方法调用没有改变集合内容，大小不变，原元素仍保留在集合中。

• 典型情况：第二次添加同一个字符串、同一对象引用、或内容相同且 equals/hashCode 正确实现的实例
• 注意：如果自定义类没重写 hashCode 和 equals，哪怕两个对象内容一样，也可能返回 true（造成逻辑重复）
• 返回 false 是高效去重的信号，可直接跳过后续处理，无需再调用 contains() 多查一次

底层其实是一次 map.put 的结果判断

HashSet 内部用 HashMap 存储，add(e) 实际执行的是 map.put(e, PRESENT) == null：

• put 返回 null → 说明 key 不存在 → add 返回 true
• put 返回非 null（即旧的 PRESENT）→ 说明 key 已存在 → add 返回 false

所以这个布尔值本质上反映的是“键是否为首次插入”，完全由 HashMap 的行为决定。

别把它当成操作成败的通用标尺

返回 false 不等于失败，而是“符合预期的无操作”。它的价值在于帮你省掉一次 contains() 调用，把去重判断和插入合并成一步。

• 适合场景：统计新增量、幂等注册、避免重复监听、标记已访问节点
• 不适合场景：单纯存数据不关心是否重复，那可以忽略返回值
• 误用风险：拿它判断“添加异常”（如空指针）是错的——add 只有在元素本身为 null 且 set 不允许 null 时才可能抛异常，和返回值无关