Java不可变集合真正不可变的是JDK 9+的List.of()等原生方法及Guava的ImmutableXXX类,而Collections.unmodifiableXXX仅为只读包装、底层仍可变;前者线程安全、内存高效、杜绝修改,后者需警惕原始引用被篡改。

Java 中的不可变集合(Immutable Collections)不是简单地“加个只读包装”,而是从创建之初就杜绝修改可能的对象。它们线程安全、节省内存(内部共享结构)、避免意外修改,是现代 Java 开发中推荐的安全实践。
用 java.util.Collections 的静态工厂方法(适合小规模、旧代码兼容)
这是 JDK 1.2 就存在的方案,但要注意:它返回的是包装视图,底层集合仍可被修改,只是通过该视图无法改——所以不真正安全。
- List
mutable = new ArrayList(Arrays.asList("a", "b")); List unmodifiable = Collections.unmodifiableList(mutable); - 调用
unmodifiable.add("c")会抛UnsupportedOperationException - 但如果有人还持有
mutable引用,并调用mutable.add("x"),unmodifiable视图内容也会变——这不是真正的不可变
用 Java 9+ 的 List.of() / Set.of() / Map.of()(推荐首选)
JDK 9 引入的工厂方法创建的是真正不可变集合:无公开构造器、无修改方法、内部状态完全封闭。
- List
list = List.of("apple", "banana"); Set set = Set.of(1, 2, 3); Map map = Map.of("a", 1, "b", 2); - 空集合也支持:
List.of()、Set.of()、Map.ofEntries()可处理空或动态键值对 - 含 null 会直接抛
NullPointerException;重复元素(如Set.of(1, 1))抛IllegalArgumentException - 所有方法(
add、remove、clear、replaceAll等)均未实现,调用即抛异常
用 Guava 的 ImmutableXXX 类(适合复杂场景或需 JDK 8 兼容)
Google Guava 提供了更丰富的不可变集合工具,支持 builder 模式、null 容忍(可选)、自定义比较器等。
立即学习“Java免费学习笔记(深入)”;
- ImmutableList
list = ImmutableList.of("x", "y"); ImmutableSet set = ImmutableSet.copyOf(Arrays.asList(1, 2, 2)); // 自动去重 - Builder 方式适合运行时构建:
ImmutableList.builder().add("a").addAll(otherList).build(); - 支持 null(如
ImmutableList.of(null)),但需明确接受风险;也提供copyOf防止原始集合后续被改 - 注意:Guava 的不可变集合是“防御性复制”,即使传入可变集合,结果也是独立、安全的副本
关键区别与使用建议
别混淆“不可变(immutable)”和“不可修改(unmodifiable)”。前者是对象本身不能变;后者只是挡了一层访问,底子还是软的。
- 新项目优先用
List.of()等 JDK 9+ 原生方式——轻量、标准、零依赖 - 需要 builder、null 支持、或还在用 JDK 8?选 Guava 的
ImmutableList等 - 避免
Collections.unmodifiableXXX作为“不可变”解决方案,除非你完全控制原始集合生命周期 - 函数式编程/Stream 终止操作(如
collect(Collectors.toUnmodifiableList()))在 JDK 10+ 也可用,语义清晰










