Java 16中Stream.toList()与Stream.collect(Collectors.toList())是否可互换？二者存在哪些行为差异？

嘿，这个问题问得特别到位——JDK 16引入的Stream.toList()确实让代码清爽了不少，但它和老伙计Collectors.toList()可不是完全能互换的，咱们得把它们的行为差异掰扯清楚，避免不小心踩坑：

核心行为差异 #

1. 返回列表的可修改性 #

• Stream.toList()返回的是不可修改列表：如果你敢对它调用add()、remove()或者set()这类修改方法，直接给你抛UnsupportedOperationException。
• Collectors.toList()返回的是可修改的ArrayList（至少在OpenJDK/Oracle JDK的默认实现里是这样）：你可以自由地给它加元素、删元素，完全没问题。

示例代码：

// 运行报错：UnsupportedOperationException
var immutableList = Stream.of(1, 2, 3).toList();
immutableList.add(4);

// 正常运行，列表变成 [1,2,3,4]
var mutableList = Stream.of(1, 2, 3).collect(Collectors.toList());
mutableList.add(4);

2. 对null元素的容忍度 #

• Stream.toList()零容忍null：如果你的流里混了null元素，调用toList()瞬间就会抛出NullPointerException。
• Collectors.toList()允许null存在：因为底层用的是ArrayList，本身就支持存储null，所以流里的null会被老老实实收集进去。

示例代码：

// 运行报错：NullPointerException
Stream.of(1, null, 3).toList();

// 正常运行，最终列表是 [1, null, 3]
Stream.of(1, null, 3).collect(Collectors.toList());

3. 返回的列表实现类 #

• Stream.toList()返回的是JDK内部封装的不可修改列表（比如java.util.ImmutableCollections.ListN），这个类是不对外暴露的，你只能把它当作List接口来用，别想着向下转型。
• Collectors.toList()返回的是标准的ArrayList，虽然官方文档没强制要求，但主流JDK实现都是这样，有些老代码甚至会直接把它转成ArrayList来用（虽然不推荐这么做）。

什么时候可以放心互换？ #

如果你的场景满足以下所有条件，那这俩方法随便换都没问题：

• 你压根不需要修改返回的列表；
• 你的流里绝对不会出现null元素；
• 你只依赖List接口的标准方法，完全不关心底层到底是啥实现类。

总结一下 #

• 追求代码简洁，且能保证流无null、不需要修改列表？选Stream.toList()准没错；
• 需要可修改的列表，或者流里可能有null？老老实实用Collectors.toList()；
• 如果需要更定制化的收集逻辑（比如指定列表初始容量、收集到LinkedList里），那还是得用Collectors.toCollection(...)这类更灵活的方法。

内容的提问来源于stack exchange，提问作者knittl