Java中创建不可变集合首选List.of()(Java9+),它返回真正不可变实例,禁止修改、不接受null、线程安全;Collections.unmodifiableList()仅包装视图,原列表被改则视图同步变化;Java10+推荐List.copyOf(),支持任意Collection、允许null、自动拷贝且高效。

Java 中创建不可变集合主要有两种方式:`List.of()`(Java 9+)和 `Collections.unmodifiableList()`。它们目标相似,但行为、限制和适用场景有明显区别。
使用 `List.of()` 创建真正不可变的列表
`List.of()` 返回的是 JVM 内置的轻量级不可变实现(如 `ImmutableCollections.ListN`),从底层禁止任何修改操作:
- 调用 add()、remove()、set()、clear() 等方法会直接抛出 UnsupportedOperationException;
- 不接受 null 元素(传入 null 会立即抛出 NullPointerException);
- 返回的集合是 序列化安全 的,且线程安全(因不可变);
- 元素个数最多支持 12 个(`List.of(e1, e2, ..., e12)`),超过需用 `List.ofArray()` 或 `Arrays.asList().copyOf()`(Java 10+)。
示例:
List<String> list = List.of("a", "b", "c");
// list.add("d"); // ❌ 运行时报 UnsupportedOperationException
// list.set(0, "x"); // ❌ 同样报错
使用 `Collections.unmodifiableList()` 包装已有列表
它不创建新集合,而是返回一个包装器视图(wrapper view),底层仍引用原列表:
立即学习“Java免费学习笔记(深入)”;
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 对包装后的列表调用修改方法会抛出 UnsupportedOperationException;
- 但如果原列表被其他引用意外修改,包装视图会反映这些变化(不是“真正不可变”);
- 允许包含 null 元素;
- 适用于任意 `List` 实现(包括自定义类),兼容性更广。
示例:
List<String> mutable = new ArrayList<>(Arrays.asList("x", "y"));
List<String> unmod = Collections.unmodifiableList(mutable);
// unmod.add("z"); // ❌ 报错
mutable.add("z"); // ✅ 原列表仍可改 → unmod.size() 变为 3!
如何选?关键看是否需要“防御性拷贝”
若你**完全控制数据来源**,且不需要 null 元素、元素不多,优先用 `List.of()` —— 更高效、语义更清晰、真正不可变。
若你要封装一个**外部传入的、可能被共享的可变列表**,又想提供只读接口,则必须先拷贝再包装:
- ❌ 错误写法:
Collections.unmodifiableList(input)(没防住源头修改); - ✅ 正确写法:
Collections.unmodifiableList(new ArrayList(input))或 Java 10+ 的List.copyOf(input)(后者更高效,且返回不可变实例)。
小提示:Java 10+ 推荐用 `List.copyOf()`
`List.copyOf()` 是 `List.of()` 的补充:它接受任意 `Collection`,自动拷贝并返回不可变列表,允许 null,且不强制元素数量限制:
- 输入为不可变集合时,可能直接返回原引用(优化);
- 输入为 null 会抛 NPE;
- 比手动 new ArrayList + unmodifiableList 更简洁安全。
示例:
List<String> source = Arrays.asList("p", null, "r");
List<String> safeCopy = List.copyOf(source); // ✅ 允许 null,且真正不可变

















