Collections.singleton用于创建只含一个元素的不可变Set，方法签名是public static Set singleton(T o)，返回集合不可修改且线程安全，适用于Java 8及以下版本中高效构建单元素集合。

在Java中，Collections.singleton 是一个非常实用的工具方法，用于创建只包含一个元素的不可变集合。这种方法不仅简洁高效，还能有效避免手动创建和封装单元素集合时可能出现的错误。

什么是 Collections.singleton 方法？

该方法属于 java.util.Collections 工具类，用于快速生成一个只包含指定元素的不可修改（unmodifiable）集合。它返回的是 Set 类型，且集合大小固定为1。

其方法签名如下：

public static Set singleton(T o)

参数 o 就是你想要放入集合中的唯一元素。返回的 Set 具备以下特性：

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

• 只能包含一个元素
• 集合本身不可修改 —— 调用 add、remove 等操作会抛出 UnsupportedOperationException
• 线程安全（因为不可变）
• 多次调用同一个对象的 singleton 返回不同的 Set 实例，但内容一致

如何使用 singleton 创建单元素集合？

使用方式非常简单，只需传入你要封装的对象即可。

Set singleSet = Collections.singleton("Hello");
System.out.println(singleSet); // 输出: [Hello]
System.out.println(singleSet.size()); // 输出: 1

你也可以用于其他类型：

Java调试

通过 JDWP 实现 Java 远程调试：连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP：Java Debug Wire Protocol，Java 调试有线协议（Java 远程调试底层通信协议） remote JVM：远程 Java 虚拟机 step through code：代码单步调试（步入 / 步过 / 步出调试） inspect variables：变量查看 / 变量检视 stac

下载

Set numbers = Collections.singleton(42);
Set userSet = Collections.singleton(currentUser);

这种写法比手动创建 HashSet 并添加元素更高效，尤其是在只需要读取、传递或比较单一值集合的场景下。

singleton 与类似方法的区别

Java 还提供了其他创建不可变集合的方法，理解它们之间的区别有助于正确选择：

• Collections.singletonList：返回只含一个元素的不可变 List，适用于需要有序访问或允许重复（逻辑上不适用）的场景
• Collections.singletonMap：创建只含一个键值对的不可变 Map
• Set.of(element)（Java 9+）：现代替代方案，支持创建不可变 Set，包括单元素和多元素。例如：Set.of("A")

如果你使用的是 Java 9 或更高版本，推荐优先使用 Set.of()，语法更直观，功能更强大。但在低版本中，Collections.singleton 依然是最佳选择。

使用建议与注意事项

虽然 Collections.singleton 很方便，但需要注意以下几点：

• 返回的集合是不可变的，任何修改操作都会抛出异常
• 如果原始对象是可变的（如自定义对象），虽然集合不能改，但对象内部状态仍可被修改
• 适合用于函数返回、参数传递、临时集合构建等场景，不适合需要动态增删的集合操作
• 性能优秀，避免了新建 ArrayList/HashSet 的开销

举个实际例子：当你写一个方法，需要返回某个默认结果集合，而大多数情况下只有一个元素时，就可以这样写：

public Set getDefaultTags() {
    return Collections.singleton("default");
}

基本上就这些。Collections.singleton 是一种轻量、安全、高效的单元素集合创建方式，合理使用能提升代码清晰度和性能。不复杂但容易忽略。