Java中将集合转为不可变对象的核心是避免后续修改,推荐使用JDK 9+的List.of()、Set.of()、Map.of()等工厂方法;Java 8可借助Collections.unmodifiableXXX()(需先防御性拷贝);工程级项目建议用Guava的ImmutableList等类。

Java 中将集合转为不可变对象,核心是**避免后续修改**,而不是简单“不写 add/remove”。真正安全的方式是使用 JDK 自带的不可变集合工厂方法,或借助第三方库(如 Guava)——它们在创建时就切断所有可变入口,且返回的实例明确拒绝修改操作。
使用 JDK 9+ 的 Immutable Collections Factory Methods
从 Java 9 开始,List.of()、Set.of()、Map.of() 及其变体(如 ofEntries()、ofNullable())是最推荐的方式。它们返回的是高度优化、轻量级、线程安全的不可变集合。
- 空集合直接用
List.of()、Set.of()、Map.of() - 含元素时传入参数:
List.of("a", "b", "c");Set.of(1, 2, 3);Map.of("k1", "v1", "k2", "v2") - 注意:这些方法不允许 null 元素(否则抛
NullPointerException),也不支持重复 key(Map.of())或重复元素(Set.of()) - 若需含 null 或动态构造,先用可变集合构建,再用
copyOf()(Java 10+):List.copyOf(new ArrayList(original))—— 它会检查并复制,返回不可变视图
兼容老版本(Java 8 及以下)的替代方案
Java 8 没有内置不可变工厂,但可通过 Collections.unmodifiableXXX() 包装已有集合,不过要特别注意它的局限性:
- 它只提供不可变视图,底层原集合仍可被修改,导致“假不可变”
- 必须确保原始集合不再被持有或修改,否则存在风险
- 典型安全用法:先 new 一份副本,再包装:
Collections.unmodifiableList(new ArrayList(originalList)) - 不建议对 Set/Map 直接包装未防御性拷贝的引用,尤其当原集合来自外部输入时
使用 Guava 库的 ImmutableXXX 类(推荐工程级项目)
Guava 提供了更强大、语义更清晰的不可变集合(如 ImmutableList、ImmutableSet、ImmutableMap),适合中大型项目:
立即学习“Java免费学习笔记(深入)”;
- 构造即不可变,且允许 null(除
ImmutableSet和ImmutableMap的 key 外) - 支持 builder 模式灵活构建:
ImmutableList.builder().add("x").addAll(list).build() - 天然支持重复元素(
ImmutableList)、null 值(ImmutableList、ImmutableMapvalue)、自定义 comparator 等 - 序列化友好,性能稳定,文档和生态成熟
关键提醒:不可变 ≠ 不可访问
不可变集合只是禁止结构和内容修改,你依然可以遍历、查询、生成流、调用 size()、contains() 等只读方法。它不是“隐藏数据”,而是保障数据一致性与线程安全的基础手段。
基本上就这些。选哪种方式,取决于你的 JDK 版本、是否引入第三方依赖、以及对 null 和构造灵活性的要求。










