在 Java 开发中，我们经常需要操作各种集合，其中 Google Guava 提供的 ImmutableMap 和 Java 自带的 Maps 工具类可谓是开发者的好帮手。然而，这些工具类也暗藏一些“巨坑”，稍有不慎就会被狠狠“绊倒”。今天，我们就来盘点这些坑点，教你如何优雅避坑。

一、ImmutableMap 是什么？

官方定义：

ImmutableMap 是 Guava 提供的一个不可变的 Map 实现，一旦创建，不允许修改，包括添加、更新或删除键值对。

import com.google.common.collect.ImmutableMap;

public class ImmutableMapDemo {
    public static void main(String[] args) {
        ImmutableMap<String, String> map = ImmutableMap.of(
                "key1", "value1",
                "key2", "value2"
        );
        System.out.println(map);
    }
}

为什么需要不可变？

• 线程安全：多个线程读写数据时，不可变对象避免了同步问题。
• 意外保护：防止误操作改变了对象状态。
• 优化性能：不可变对象有更好的哈希计算性能。

二、Maps 的便捷用法

Maps 是 Guava 提供的工具类，可以快速创建常用的 Map。比如：

import com.google.common.collect.Maps;

public class MapsDemo {
    public static void main(String[] args) {
        // 快速创建 HashMap
        Map<String, Integer> map = Maps.newHashMap();
        map.put("Alice", 25);
        map.put("Bob", 30);
        System.out.println(map);
    }
}

三、让人抓狂的“巨坑”

1. ImmutableMap 的“陷阱”

(1) 无法容忍重复的键

创建 ImmutableMap 时，如果存在重复键，代码直接崩溃。

ImmutableMap<String, String> map = ImmutableMap.of(
    "key1", "value1",
    "key1", "value2"  // 重复键
);

运行结果：

Exception in thread "main" java.lang.IllegalArgumentException: Multiple entries with same key: key1=value1 and key1=value2

如何避坑？

在构造 ImmutableMap 前，一定要确保数据源无重复键，可以借助 HashMap 先进行去重。

(2) 修改不可变 Map 会报错

ImmutableMap<String, String> map = ImmutableMap.of(
    "key1", "value1",
    "key2", "value2"
);
map.put("key3", "value3");  // 报错

运行结果：

Exception in thread "main" java.lang.UnsupportedOperationException

如何避坑？

如果你需要修改 Map，请选择可变的 HashMap，或者在初始创建时规划好所有键值。

2. Maps 的“奇葩”行为

(1) Maps.newHashMap() 默认容量问题

Maps.newHashMap() 的默认初始容量为 16，但是随着数据增长，如果未设置容量，Map 会触发多次 resize（扩容），性能损耗较大。

Map<Integer, String> map = Maps.newHashMap();
for (int i = 0; i < 100; i++) {
    map.put(i, "Value " + i);
}

隐形问题：

• 如果数据量较大，而没有指定初始容量，扩容将耗费大量时间。
• 开发时常被忽略，尤其是在大数据处理中。

如何避坑？

使用 Maps.newHashMapWithExpectedSize(int expectedSize) 显式指定初始容量：

Map<Integer, String> map = Maps.newHashMapWithExpectedSize(100);

(2) Maps.newHashMap() 和 JDK 的 HashMap 不兼容？

在某些极端情况下，Maps 的实现可能会引发与 JDK 的默认行为不一致的问题。例如，使用某些特殊泛型时，可能需要手动类型转换。

四、综合对比和建议

使用建议：

0. 需要线程安全且不变时，使用 ImmutableMap：
1. 确保数据源无重复键；
2. 确保初始化时即包含所有数据。
3. 频繁修改的场景，使用 Maps.newHashMap()：
4. 数据量较大时，记得设置初始容量，避免扩容。
5. 多线程场景：
6. 考虑使用 ConcurrentHashMap 或 Collections.synchronizedMap()。

五、实战演示：如何优雅避坑？

场景：将用户输入的列表转换成不可变 Map

需求：用户输入一个字符串数组，转换成 ImmutableMap，键为字符串，值为其长度。

错误代码：直接使用 ImmutableMap.of()

ImmutableMap<String, Integer> map = ImmutableMap.of(
    "Alice", 5,
    "Bob", 3,
    "Alice", 6  // 重复键
);

正确代码：先去重再构建

import com.google.common.collect.ImmutableMap;
import java.util.HashMap;

public class AvoidPitfalls {
    public static void main(String[] args) {
        String[] inputs = {"Alice", "Bob", "Alice"};
        
        // 1. 用 HashMap 去重
        HashMap<String, Integer> tempMap = new HashMap<>();
        for (String input : inputs) {
            tempMap.put(input, input.length());
        }

        // 2. 转换成 ImmutableMap
        ImmutableMap<String, Integer> map = ImmutableMap.copyOf(tempMap);
        System.out.println(map);
    }
}

输出：

{Alice=5, Bob=3}

六、总结

ImmutableMap 和 Maps 是 Guava 提供的高效工具，但在使用时也暗藏“陷阱”。了解它们的工作原理和限制，可以帮助你避免踩坑，并在项目中更加从容地使用它们。

开发者金句：

用好工具，少挖坑；避开巨坑，省头发！

希望这篇文章能帮你在开发中少踩雷，写出优雅的代码！有什么问题，欢迎评论区交流~