如何使用 Collections.emptyList() 实现安全且节省内存的空列表创建?

2026-04-29 09:182阅读0评论SEO基础
  • 内容介绍
  • 相关推荐

本文共计960个文字,预计阅读时间需要4分钟。

如何使用 Collections.emptyList() 实现安全且节省内存的空列表创建?

该返回的是一个静态单例对象,类型为 `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分钟。

如何使用 Collections.emptyList() 实现安全且节省内存的空列表创建?

该返回的是一个静态单例对象,类型为 `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」更重要。