怎么利用Collections.singletonList创建不可变的单元素集合

文章不知道大家是否熟悉？今天我将给大家介绍《怎么利用Collections.singletonList创建不可变的单元素集合》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

Collections.singletonList 返回不可变集合，因其私有内部类 SingletonList 重写所有修改方法并抛出 UnsupportedOperationException，仅保证结构不可变，不阻止元素内容修改。

为什么 Collections.singletonList 返回的集合不可变

它返回的是一个私有静态内部类 SingletonList，该类重写了所有可能修改集合的方法（如 add、remove、set），全部抛出 UnsupportedOperationException。不是靠包装或防御性拷贝，而是从设计上禁止任何写操作。

注意：它不阻止对元素本身的修改——如果元素是可变对象（比如 ArrayList），你仍能调用其方法改变内容；不可变的是集合结构本身。

怎么安全地创建并使用单元素不可变集合

直接调用即可，传入任意非 null 元素（null 本身也是合法元素）：

List<String> list = Collections.singletonList("hello");

常见误用点：

• 误以为能后续添加：调用 list.add("world") 会立即抛出 UnsupportedOperationException
• 误当成线程安全集合：它不可变 ≠ 线程安全的“并发容器”，只是无状态、无写操作，天然适合多线程读取
• 与 Arrays.asList("x") 混淆：Arrays.asList 返回的仍是可变列表（支持 set），而 singletonList 连 set 都不支持

和 Java 9+ List.of() 的区别在哪

两者都返回不可变集合，但行为细节不同：

• Collections.singletonList("a") 明确只接受一个参数，类型擦除后仍是 List，运行时无额外检查
• List.of("a") 是可变参数方法，支持零个或多个元素；传入 null 会抛 NullPointerException（而 singletonList(null) 合法）
• List.of() 返回的实例更轻量，且在 JDK 内部做了更多优化（如空集合复用）；但若你明确只要单元素，用 singletonList 语义更清晰、无歧义

容易被忽略的兼容性细节

这个方法自 JDK 1.2 就存在，所以无需担心低版本兼容问题；但它返回的不是 ImmutableList（Guava）或 ImmutableList（JDK 14+ Sealed Classes 相关新类型），只是一个普通 List 接口实现。

如果你需要序列化、泛型推断更稳、或和 Stream API 配合更自然，注意：

• 它实现了 Serializable，但反序列化后仍是不可变的
• 用在泛型方法中时，类型推断通常没问题，但若遇到 Object 擦除，建议显式声明类型参数：Collections.singletonList(42)
• 别试图把它强转成 ArrayList 或其他具体类型——它就是 SingletonList，没有公开构造器，也不对外暴露类型名

本篇关于《怎么利用Collections.singletonList创建不可变的单元素集合》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！