Java中如何用Collections.singleton和nCopies高效创建单元素与固定元素集合？

Collections.singleton 和 Collections.nCopies 是 Java 集合框架中两个常被忽视但非常实用的工具方法。它们分别用于创建只包含单个元素的不可变集合，以及包含固定数量重复元素的不可变列表。与直接 new 一个 ArrayList 再逐个添加元素相比，这两个方法在代码简洁性、内存占用和语义表达上都有明显优势。理解它们的内部实现和限制，可以帮助开发者在合适的场景下写出更安全、更高效的代码。

一、Collections.singleton 的内部实现与不可变约束

Collections.singleton(T o) 方法返回一个只包含指定对象的不可变 Set。它的方法签名是 public static <T> Set<T> singleton(T o)，同时还存在一个对应的 singletonList(T o) 方法用于返回不可变 List。从源码实现来看，singleton 并没有创建一个全新的 HashSet 或 ArrayList，而是返回了 Collections 内部的轻量级实现类 SingletonSet 或 SingletonList。这些内部类继承自 AbstractSet 或 AbstractList，只保存一个元素引用，并覆写了 size、contains、get 等读取方法，但不支持任何修改操作。

这种设计的最大好处是内存占用极低。SingletonSet 内部仅有一个字段指向传入的对象，而 HashSet 底层需要维护一个 HashMap，包含哈希桶数组、负载因子、阈值等多个字段，即使只放一个元素也要分配较大的空间。对于只需要传递一个只读元素的场景，singleton 方法避免了不必要的对象创建和内存浪费。同时，它传达了一个明确的语义：这个集合不可以被修改。任何试图调用 add、remove、clear 等方法都会抛出 UnsupportedOperationException。

下面的代码展示了 singleton 的基本用法以及修改操作会触发的异常。可以看到，读取操作完全正常，但一旦涉及结构性修改，方法就会立即失败。

import java.util.Collections;
import java.util.Set;

public class SingletonDemo {
    public static void main(String[] args) {
        Set<String> single = Collections.singleton("only");
        System.out.println(single.size());      // 输出 1
        System.out.println(single.contains("only")); // 输出 true

        try {
            single.add("another");
        } catch (UnsupportedOperationException e) {
            System.out.println("集合不可修改，添加元素失败");
        }
    }
}

需要注意的是，singleton 允许传入 null 值，返回的集合中会包含一个 null 元素。这一点与 Java 9 引入的 Set.of() 和 List.of() 不同，后者明确禁止 null 元素。因此如果业务上需要表示“存在一个空值”的只读集合，singleton 是更合适的选择。

二、Collections.nCopies 的重复引用机制与内存优势

Collections.nCopies(int n, T o) 返回一个包含 n 个指定对象引用的不可变 List。它的方法签名是 public static <T> List<T> nCopies(int n, T o)。这个方法的实现类 CopiesList 继承自 AbstractList，内部只保存两个字段：重复次数 n 和对象引用 o。所有索引位置上调用 get 方法时，都会返回同一个对象引用，而不会为每个位置复制一份新对象。也就是说，无论 n 有多大，底层存储的内存占用始终是常数级别。

这种共享引用的机制非常适合填充不可变对象或占位场景。例如在测试中需要创建一个包含 1000 个相同默认值的列表，使用 nCopies 只需要保存一个默认值对象，而使用循环 new ArrayList 添加 1000 次则会创建 1000 个独立对象。效率差异非常明显。不过要特别注意：如果传入的对象本身是可变的，那么修改其中任意一个元素都会影响到列表中的所有元素，因为它们本质上是同一个对象。这个特性有时是优点，有时则是隐藏的陷阱。

下面对比了 nCopies 与普通循环填充两种方式在代码量和对象创建上的差异。示例中创建了一个包含三个 StringBuilder 的列表，并验证所有位置都指向同一个实例。

import java.util.Collections;
import java.util.List;

public class NCopiesDemo {
    public static void main(String[] args) {
        StringBuilder shared = new StringBuilder("item");
        List<StringBuilder> copies = Collections.nCopies(3, shared);

        System.out.println(copies.size()); // 输出 3
        System.out.println(copies.get(0) == copies.get(1)); // 输出 true
        System.out.println(copies.get(1) == copies.get(2)); // 输出 true

        copies.get(0).append("-changed");
        System.out.println(copies.get(2)); // 输出 item-changed
    }
}

从输出结果可以清楚看到，三个位置引用的是同一个 StringBuilder 实例。第 0 个元素上的修改会直接反映到第 2 个元素上。因此在使用 nCopies 时，如果每个位置需要独立对象，应当改用循环或者结合 stream 生成。

三、不可变集合的异常行为与常见误区

Collections.singleton 和 nCopies 返回的集合被称为不可变集合，但它们的不可变性并不等同于完全冻结。集合本身的结构不可修改，但集合中保存的对象引用仍然可以指向可变对象。如果外部持有该对象的引用，或者通过集合的 get 方法拿到对象后调用其自身的修改方法，对象内部状态仍然会发生变化。开发者需要区分“集合不可修改”和“对象不可修改”这两个概念。

另一个常见的误区是把这两个方法与 Collections.unmodifiableList 或 Collections.unmodifiableSet 混淆。后者是包装一个已经存在的可变集合，虽然包装后不能修改，但原始集合仍然可以修改，并且修改会反映到包装视图中。而 singleton 和 nCopies 是直接返回一个从创建起就不支持修改的集合，没有底层可变集合可以绕过。因此它们更适合作为常量或只读数据返回给调用方。

在异常行为上，这两个方法返回的集合对所有结构性修改操作都会抛出 UnsupportedOperationException。例如对 singleton 集合调用 add、remove、clear，对 nCopies 列表调用 add、remove、set 都会失败。迭代器本身也不支持 remove。下面代码演示了 nCopies 上调用 set 方法时的异常表现。

import java.util.Collections;
import java.util.List;

public class ModifyNCopies {
    public static void main(String[] args) {
        List<String> list = Collections.nCopies(5, "fixed");
        try {
            list.set(0, "new");
        } catch (UnsupportedOperationException e) {
            System.out.println("nCopies 返回的列表不支持 set 操作");
        }
    }
}

理解这些异常行为有助于在接口设计时避免误用。如果一个方法返回了 singleton 或 nCopies 集合，调用方应当明确知道该集合是只读的，不应尝试修改。否则在运行时才暴露异常，可能造成线上故障。

四、与 List.of、Set.of 的选择及实际应用场景

Java 9 引入了 List.of() 和 Set.of() 等集合工厂方法，它们同样用于创建不可变集合。相比之下，Collections.singleton 和 nCopies 的优势主要体现在兼容性和 null 值处理上。List.of 和 Set.of 从 Java 9 才开始提供，如果项目仍需要兼容 Java 8 或更早版本，只能使用 Collections 工具类的方法。此外，List.of 和 Set.of 明确不允许包含 null 元素，而 singleton 和 nCopies 都允许 null，这在某些老代码或特殊业务场景中是必要的。

实际开发中，singleton 常用于方法需要 Collection 参数但调用方只有一个元素的场景。例如某个接口要求传入一组标签，而当前只有一个标签值，此时直接写 Collections.singletonList(tag) 比创建临时 ArrayList 更加清晰。nCopies 则常用于构造默认值列表、初始化固定大小的占位数据、或者在测试中快速生成大量重复测试数据。相比手动循环，一行代码即可表达意图，并且不会产生大量重复对象。

选择这些方法时，需要根据集合是否允许 null、目标 Java 版本、以及是否需要独立对象来决定。对于单元素只读集合，优先使用 singleton 或 singletonList；对于大量重复引用且对象不可变或只读的场景，优先使用 nCopies；如果项目已经基于 Java 9 以上且元素不含 null，也可以使用 List.of 和 Set.of。无论选择哪一种，都应当清楚地对外说明返回集合的不可变性质，避免调用方误修改导致运行时异常。

Collections.singletonnCopies不可变集合修改时间：2026-08-26 11:15:25