Java集合转不可变对象技巧

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Java集合转不可变对象方法》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

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），适合中大型项目：

• 构造即不可变，且允许 null（除 ImmutableSet 和 ImmutableMap 的 key 外）
• 支持 builder 模式灵活构建：ImmutableList.builder().add("x").addAll(list).build()
• 天然支持重复元素（ImmutableList）、null 值（ImmutableList、ImmutableMap value）、自定义 comparator 等
• 序列化友好，性能稳定，文档和生态成熟

关键提醒：不可变 ≠ 不可访问

不可变集合只是禁止结构和内容修改，你依然可以遍历、查询、生成流、调用 size()、contains() 等只读方法。它不是“隐藏数据”，而是保障数据一致性与线程安全的基础手段。

基本上就这些。选哪种方式，取决于你的 JDK 版本、是否引入第三方依赖、以及对 null 和构造灵活性的要求。

到这里，我们也就讲完了《Java集合转不可变对象技巧》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！