Java 10 的 Collectors.toUnmodifiableList() 在流收集阶段直接构建不可变 List,避免中间可变副本,比 Collections.unmodifiableList 更安全高效,适用于 static final 常量初始化。

Java 10 引入了 Collectors.toUnmodifiableList(),它能直接在流操作中生成不可修改的 List,非常适合用于初始化 static final 常量集合——既简洁又安全,避免了手动包装或额外依赖。
为什么用 toUnmodifiableList 而不是 Collections.unmodifiableList?
Collections.unmodifiableList(new ArrayList(...)) 需要先创建可变副本,再包装,多一次对象分配且易出错(比如忘了包装);而 toUnmodifiableList() 在收集阶段就构造不可变实现(底层是 ImmutableCollections.ListN),无中间可变状态,内存更省、语义更清晰。
正确声明常量 List 的写法
必须确保初始化发生在静态上下文中,并且流源本身不带副作用(如依赖运行时状态)。推荐写法:
public static final List<String> SUPPORTED_FORMATS =
Stream.of("JSON", "XML", "YAML")
.collect(Collectors.toUnmodifiableList());
public static final List<Integer> PRIMES_UNDER_10 =
Arrays.asList(2, 3, 5, 7)
.stream()
.collect(Collectors.toUnmodifiableList());
- 直接使用
Stream.of或Arrays.asList(...).stream()是最常见、最安全的源头 - 避免从外部可变集合(如某个类字段)流式转换,否则常量可能间接被修改
- 类型需显式声明(如
List<string></string>),不能用var,因为返回类型是具体不可变实现,不是接口别名
注意 null 和重复元素的处理
toUnmodifiableList() 不拒绝 null 元素,也不去重。若业务要求非空或唯一,需提前过滤:
立即学习“Java免费学习笔记(深入)”;
public static final List<String> NON_NULL_NAMES =
Stream.of("Alice", null, "Bob", "Charlie")
.filter(Objects::nonNull)
.collect(Collectors.toUnmodifiableList());
public static final List<String> UNIQUE_TAGS =
Stream.of("java", "java", "spring", "web")
.distinct()
.collect(Collectors.toUnmodifiableList());
-
filter(Objects::nonNull)可防止null进入常量列表(否则后续调用可能触发NullPointerException) -
distinct()在流中去重,适合构建逻辑上唯一的标签、枚举值等 - 这些操作仍保持不可变性——流管道整体输出仍是不可修改列表
替代方案对比与适用场景
虽然 toUnmodifiableList() 是首选,但某些场景仍有其他选择:
-
极小固定集合(≤5 个元素):可用
List.of("a", "b", "c")(Java 9+),更轻量,无需流 -
需要 Set/Map 常量:对应有
Collectors.toUnmodifiableSet()和toUnmodifiableMap() -
需兼容 Java 8:退回
Collections.unmodifiableList(Arrays.asList(...)),但记得加final修饰和文档说明


















