HashSet不保证元素顺序，因其底层基于HashMap的键存储机制，仅按哈希值决定存放位置，与插入顺序无关；若需有序，可选用LinkedHashSet或TreeSet。
HashSet 不保证元素顺序，根本原因在于它的底层实现完全依赖 HashMap 的键存储机制，而 HashMap 本身不维护插入顺序——它只按哈希值决定元素存放位置。
底层用的是 HashMap，key 就是元素本身
每次调用 add(e)，实际执行的是 map.put(e, PRESENT)。也就是说，HashSet 中的每个元素都被当作 HashMap 的 key 存进去。HashMap 的 key 是无序的，它只靠 hash(key) 计算索引，把元素放到数组的某个桶（bucket）里。这个索引由哈希值与数组长度做位运算（&）得出，和插入先后毫无关系。
哈希值决定位置，不是插入顺序
比如你依次 add("java")、add("world")、add("hello")，它们的 hashCode() 值不同，算出的数组下标就可能分别是 5、12、1 —— 所以遍历时看到的顺序是 [hello, java, world] 这类“乱序”。这不是 bug，是设计使然。即使同一批数据反复运行，只要 JVM 和类没变、hashCode 没重写，输出顺序通常也稳定（因为 hash 计算确定），但这仍不叫“有序”，只是“可重现的无序”。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
没有链表或树的插入时序保障
虽然 HashMap 在桶内用链表或红黑树处理哈希冲突，但这些结构只服务于查找效率，不记录插入时间。链表节点是头插还是尾插（JDK 8 后是尾插），不影响整体遍历顺序逻辑；红黑树按 key 的自然顺序或比较器排序，但 HashSet 并不利用这个特性——它根本不提供排序能力，也不要求元素实现 Comparable。
立即学习“Java免费学习笔记（深入）”；
想有序怎么办？有明确替代方案
- 要按插入顺序：用 LinkedHashSet，它在 HashMap 外加了双向链表维护插入顺序
- 要按自然/自定义顺序：用 TreeSet，基于红黑树，支持排序但性能略低（O(log n)）
- 如果只是临时需要有序输出：可以转成 List 后用 Collections.sort() 或流式 sorted()
基本上就这些。HashSet 的无序不是缺陷，而是为 O(1) 查找和去重做的合理取舍。
