17370845950

Collections.singletonList 是 Java 中创建只含一个元素的不可变列表的方法，返回轻量级、只读的 List 实现；2. 它比 new ArrayList() 更节省内存、性能更高，适用于无需修改的单元素场景；3. 使用时传入任意类型元素即可，支持 null 值，但禁止修改操作，否则抛出异常；4. 推荐用于函数返回、参数传递等只读上下文，提升代码可读性和安全性。

在Java中，Collections.singletonList 是一个非常实用的工具方法，用于创建只包含一个元素的不可变列表。它不仅简洁高效，还能节省内存，适用于那些只需要读取、不需要修改集合的场景。

什么是 Collections.singletonList？

它是 java.util.Collections 类中的静态方法，返回一个只包含指定元素的不可变（unmodifiable）List。由于内部做了优化，这个列表不支持添加、删除或修改操作，任何尝试修改它的行为都会抛出 UnsupportedOperationException。

方法签名如下：

它返回的是一个轻量级的 List 实现，特别适合用在函数返回值、参数传递或临时数据封装中。

如何正确使用 singletonList

使用方式非常简单，传入你要包装的元素即可：

• String 单元素列表：
  List list = Collections.singletonList("Hello");
• Integer 类型示例：
  List numbers = Collections.singletonList(42);
• 自定义对象也适用：
  User user = new User("Alice");
  List userList = Collections.singletonList(user);

这个列表虽然不可变，但可以安全地用于遍历、查找等只读操作。

与 new ArrayList 的对比优势

相比手动创建 ArrayList 并添加一个元素，singletonList 更高效：

• 内存更省：不会预先分配多余容量，也没有动态扩容机制。
• 性能更高：无需调用 add() 方法，构造过程更轻量。
• 线程安全：由于不可变，多个线程访问时无需额外同步。
• 语义清晰：明确表达“仅有一个元素”的意图，增强代码可读性。

例如，以下两种写法效果不同：

注意事项和常见误区

虽然方便，但使用时需注意几点：

• 返回的列表是不可变的，调用 add/remove/set 会抛异常。
• 元素本身可以是 null，Collections.singletonList(null) 是合法的，会返回一个包含 null 的列表。
• 如果后续需要修改集合，应使用 ArrayList 或其他可变集合类型。
• 不要对返回结果做强转或试图反射修改，破坏封装可能导致不可预期行为。

基本上就这些。当你只需要一个只读的单元素列表时，Collections.singletonList 是最佳选择——简单、安全、高效。