Collections.singletonList创建不可变单元素列表,2. Collections.singletonMap创建不可变单键值对映射,二者均线程安全、高效节省内存,适用于只读场景如返回单元素集合或配置传递,不支持修改操作且允许null值,但需注意不可变性限制。

在Java中,Collections.singletonList 和 Collections.singletonMap 是两个非常实用的工具方法,用于创建不可变的单元素集合和单键值对映射。它们属于 java.util.Collections 类中的静态方法,适用于需要轻量级、只读集合的场景。
singletonList:创建不可变的单元素列表
当你只需要一个只包含一个元素的 List,并且不希望这个列表被修改时,可以使用 Collections.singletonList。
它返回一个线程安全、不可修改的 List 视图,访问效率高,不会额外创建复杂的结构。
示例:
立即学习“Java免费学习笔记(深入)”;
String name = "Alice";
List
注意:
- 返回的 List 不支持 add、remove、clear 等修改操作,调用这些方法会抛出 UnsupportedOperationException。
- 由于是视图形式,传入的对象仍可被外部修改(如果是可变对象),但集合结构本身不可变。
- 比 new ArrayList(Arrays.asList(obj)) 更高效,避免了额外的内存开销。
singletonMap:创建不可变的单键值对映射
当你只需要存放一个键值对的 Map 时,Collections.singletonMap 是理想选择。
专业级别的大型网站建站产品,JAVA技术的CMS管理系统,ospod提供上百套专业模板供您选择,包括审批工作流,流量统计和流行网络应用,是公司企业建设专业网站的首选产品,也使用于专业建站人士完成复杂网站项目。管理地址cmsadmin登陆用户名:ospod 密码:ospod1234
它返回一个不可变的 Map,其中仅包含指定的一个键和一个值。
示例:
立即学习“Java免费学习笔记(深入)”;
Integer userId = 1001;
String userName = "Bob";
Map
特点:
- 同样不可修改,任何 put、remove 操作都会抛出异常。
- 线程安全,适合在多线程环境中作为常量数据传递。
- 内部实现简洁,节省内存,适用于配置、临时返回值等场景。
适用场景与注意事项
这两个方法特别适合以下情况:
- 方法需要返回一个 List 或 Map,但结果只有一个元素。
- 作为参数传递时,避免创建匿名集合对象。
- 在 Stream 中作为默认值或兜底值使用。
注意事项:
- 允许传入 null 值(包括 key 或 value 为 null),但需调用者自行保证逻辑正确。
- 返回的是不可变集合,不能重新赋值结构。
- 如果后续需要修改集合内容,应使用 ArrayList 或 HashMap 等可变类型。
基本上就这些。合理使用 singletonList 和 singletonMap 能让代码更简洁、安全,同时提升性能表现。









