Java里的Google Guava集合类库怎么用

Guava不可变集合无public结构器，必须通过静态工厂创建，如Immutablelistt等.of()或copyof()，修改操作抛unsupportedoperationexception；Multimap简化嵌套列表管理；Stream直接collecttttam(ImmutableList.toImmutableList())；JDK21Imutablelist没有实现 SequencedCollection。

ImmutableList、ImmutableSet 为什么不能直接？ new

Guava 不可变集合不依赖 final 装饰的普通集合，而是全新结构的只读实现。你写的new ImmutableList()会编译失败-它没有 public 构造器。

正确的入口只有静态工厂方法，核心是「构建即冻结」逻辑:一旦生成，任何修改操作(如add()、remove()）都会抛UnsupportedOperationException。

• 用ImmutableList.of("a", "b")最多创建小固定集合(创建小固定集合( 5 个元素）
• 超过 5 个或需要从现有集合转换，使用ImmutableList.copyOf(list)；注意传入 null 会直接 NPE，建议先判空
• ImmutableSet.copyOf(collection)自动去除重复元素，但不保证顺序(底层使用)ImmutableHashSet），要有序用ImmutableSortedSet

Multimap 代替 Map> 的真实代价

写Map<string list>></string>手动管理嵌套列表非常麻烦：每次 put 前得检查 key 是否存在、list 是空的，是否想要 new ArrayList。而Multimap包装这件事，但代价是它不继承Map接口，不能直接做 Map 用。

• 常用的是ArrayListMultimap.create()(值按插入顺序)和HashMultimap.create()(值无序，内存更省)
• put("k1", 1)和put("k1", 2)后，get("k1")返回是不可修改的Collection视图，不能调整clear()或remove()—— 想删除一个值得使用的remove("k1", 1)
• 若需要支持 null key 或 null value，必须选LinkedHashMultimap或显式 wrap，因为默认禁止 null

ImmutableList.copyOf() 流式处理中容易误踩坑

很多人在 Stream 后接collect(Collectors.toList())，再传给ImmutableList.copyOf()，认为双重保险。事实上，没有必要再经历一次。

• Stream 本身有toList()（Java 16+)，返回是不可变的 List，但它是 JDK 实现，和 Guava 无关；Guava 的ImmutableList.toImmutableList()是配套收集器
• 错误写法：stream.collect(Collectors.toList()).stream().collect(ImmutableList.toImmutableList())—— 白跑两轮
• 正确写法：stream.collect(ImmutableList.toImmutableList())，而且收集器内部做了短路优化，遇到了 null 元素会立即报告NullPointerException，直到遍历才崩溃，而不是延迟
• 如果 stream 可能为空，toImmutableList()回来的是空的ImmutableList，不是 null，这点比自己 new ArrayList 安全

Guava 集合和 JDK 21+ SequencedCollection 的关系

Java 21 引入了SequencedCollection，让LinkedList、ArrayDeque支持统一getFirst()/getLast()。但它和 Guava 不可变集合没有交集——Guava 的ImmutableList这个接口没有实现，JDK 也没有让它实现的计划。

• 这意味着：你不能正确ImmutableList调用getFirst()，即使内部是数组实现；如果你想拿起头尾，你只能用它；get(0)和get(size() - 1)，并自己判空
• 如果你的代码同时依赖于它 JDK 新 API 和 Guava，例如，不要假设行为兼容；SequencedCollection.reversed()返回的是新视图，而ImmutableList.reverse()这是一个真正的反序副本，内存费用不同
• 现在最稳定的混合方式：把手 Guava 集合作为数据源，转化为 JDK 接口（如list.stream()）再进新 API 流程

不可变性和多值映射的边界非常清晰，但具体到每个工厂的方法 null 处理、空集合返回值和和 JDK 新特性的错位是写代码时真正卡住人的地方。