如何使用 Collections.emptyList() 实现安全且节省内存的空列表创建?
- 内容介绍
- 相关推荐
本文共计960个文字,预计阅读时间需要4分钟。
该返回的是一个静态单例对象,类型为 `ImmutableCollections.EmptyList(Java 9 及以上)或内部私有静态类(Java 8 及以前)。整个过程中不分配新数组、不创建新对象。所有调用共享同一个实例,内存占用恒定为常量级 —— 本质上就是一个全局共享的空引用容器。
但正因如此,它不允许任何修改操作:调用 add()、remove()、set() 都会立即抛出 UnsupportedOperationException。这不是 bug,是设计使然。
什么时候该用 Collections.emptyList(),什么时候不该用
适合场景:
- 作为方法返回值,表示“查无结果”且调用方本就不该修改它(如 DAO 层查询返回
List<User>) - 初始化字段时提供默认值:
private List<String> tags = Collections.emptyList(); - 构建不可变配置集合:
public static final List<String> SUPPORTED_FORMATS = Collections.emptyList();
不适合场景:
- 你需要后续往里
add()元素 —— 改用new ArrayList<>() - 你要传给某个只接受
ArrayList的 API(比如某些反射工具强转类型)—— 它不是ArrayList子类 - 你依赖
==判断是否为空列表(虽然两个emptyList()调用结果确实==,但这是实现细节,不应依赖)
Collections.emptyList() 的泛型擦除与类型安全
它实际声明为 <T> List<T> emptyList(),编译期靠类型推导补全泛型,运行时仍为原始类型。这意味着:
- 写
Collections.emptyList()时,如果上下文没提供类型信息(比如单独赋值给Object),会触发「未检查转换」警告 - 推荐显式指定类型参数:
Collections.<String>emptyList(),尤其在 Java 7/8 中 - Java 10+ 可用
var list = Collections.emptyList();,类型由左侧推导,更安全
注意:它不会帮你做运行时类型检查 —— 如果你把它赋给 List<Integer> 再试图加字符串,编译就过不去;但若绕过泛型(比如用反射),照样能塞错类型,只是空列表本身没地方存罢了。
替代方案对比:为什么不用 Arrays.asList() 或 new ArrayList<>()
三者关键差异:
-
Collections.emptyList():单例、不可变、零内存开销(除静态引用本身)、线程安全(因为不可变) -
Arrays.asList():返回固定大小列表,底层是原数组;空数组调用如Arrays.asList(new String[0])仍会新建数组对象,浪费内存 -
new ArrayList<>():每次调用都新建对象,含初始容量数组(通常 10 个元素空间),哪怕你马上丢弃它
如果你只是需要一个「空」语义,又不打算改,那后两者纯属多占堆内存和 GC 压力。不过要注意:emptyList() 和 new ArrayList<>() 在 equals() 和 hashCode() 行为上一致,可以互换比较。
真正容易被忽略的一点是:它和 null 完全不同。返回 null 强迫调用方判空,而返回 emptyList() 让调用方自然遍历零次 —— 这种防御性编程习惯比记住「何时该 new」更重要。
本文共计960个文字,预计阅读时间需要4分钟。
该返回的是一个静态单例对象,类型为 `ImmutableCollections.EmptyList(Java 9 及以上)或内部私有静态类(Java 8 及以前)。整个过程中不分配新数组、不创建新对象。所有调用共享同一个实例,内存占用恒定为常量级 —— 本质上就是一个全局共享的空引用容器。
但正因如此,它不允许任何修改操作:调用 add()、remove()、set() 都会立即抛出 UnsupportedOperationException。这不是 bug,是设计使然。
什么时候该用 Collections.emptyList(),什么时候不该用
适合场景:
- 作为方法返回值,表示“查无结果”且调用方本就不该修改它(如 DAO 层查询返回
List<User>) - 初始化字段时提供默认值:
private List<String> tags = Collections.emptyList(); - 构建不可变配置集合:
public static final List<String> SUPPORTED_FORMATS = Collections.emptyList();
不适合场景:
- 你需要后续往里
add()元素 —— 改用new ArrayList<>() - 你要传给某个只接受
ArrayList的 API(比如某些反射工具强转类型)—— 它不是ArrayList子类 - 你依赖
==判断是否为空列表(虽然两个emptyList()调用结果确实==,但这是实现细节,不应依赖)
Collections.emptyList() 的泛型擦除与类型安全
它实际声明为 <T> List<T> emptyList(),编译期靠类型推导补全泛型,运行时仍为原始类型。这意味着:
- 写
Collections.emptyList()时,如果上下文没提供类型信息(比如单独赋值给Object),会触发「未检查转换」警告 - 推荐显式指定类型参数:
Collections.<String>emptyList(),尤其在 Java 7/8 中 - Java 10+ 可用
var list = Collections.emptyList();,类型由左侧推导,更安全
注意:它不会帮你做运行时类型检查 —— 如果你把它赋给 List<Integer> 再试图加字符串,编译就过不去;但若绕过泛型(比如用反射),照样能塞错类型,只是空列表本身没地方存罢了。
替代方案对比:为什么不用 Arrays.asList() 或 new ArrayList<>()
三者关键差异:
-
Collections.emptyList():单例、不可变、零内存开销(除静态引用本身)、线程安全(因为不可变) -
Arrays.asList():返回固定大小列表,底层是原数组;空数组调用如Arrays.asList(new String[0])仍会新建数组对象,浪费内存 -
new ArrayList<>():每次调用都新建对象,含初始容量数组(通常 10 个元素空间),哪怕你马上丢弃它
如果你只是需要一个「空」语义,又不打算改,那后两者纯属多占堆内存和 GC 压力。不过要注意:emptyList() 和 new ArrayList<>() 在 equals() 和 hashCode() 行为上一致,可以互换比较。
真正容易被忽略的一点是:它和 null 完全不同。返回 null 强迫调用方判空,而返回 emptyList() 让调用方自然遍历零次 —— 这种防御性编程习惯比记住「何时该 new」更重要。

