在Java中如何判断集合是否为空_Java集合判空最佳实践

最安全推荐的方式是先判空再调用isEmpty(),因直接调用isEmpty()或size()在集合为null时会抛NullPointerException,而Objects.isNull()或CollectionUtils可提升语义清晰度与null安全性。

Java中判断集合是否为空,最安全、最推荐的方式是先判空再判尺寸,即 先检查集合引用是否为 null,再调用 isEmpty()。直接调用 list.isEmpty() 而不校验 null,一旦集合为 null 就会抛出 NullPointerException。

为什么不能只用 collection.isEmpty()

isEmpty() 是 Collection 接口定义的方法,所有标准集合(ArrayList、HashSet、LinkedList 等)都支持。但它要求调用对象非 null。常见误区是:

  • 错误写法: if (list.isEmpty()) —— 若 list == null,直接报错
  • 危险写法: if (list.size() == 0) —— 同样对 null 不安全,且效率略低(size() 可能涉及计算,而 isEmpty() 通常更轻量)

推荐的判空写法(兼顾安全与简洁)

✅ 标准两步法(最清晰、无依赖):

  • if (list != null && !list.isEmpty())
  • if (list == null || list.isEmpty()) // 表示“为空或不存在”

✅ 使用 Objects.isNull()(JDK7+,语义更明确):

  • if (!Objects.isNull(list) && !list.isEmpty())
  • if (Objects.isNull(list) || list.isEmpty())

✅ 使用 Apache Commons Collections(项目已引入该库时):

  • if (CollectionUtils.isNotEmpty(list)) // 内部已做 null 安全处理
  • if (CollectionUtils.isEmpty(list))

Stream 和 Optional 场景下的注意事项

若集合来自方法返回值(尤其可能为 null 的旧代码或外部 API),不要假设它一定被初始化:

  • 避免:list.stream().filter(...).findFirst().orElse(null) —— 若 list 为 null,stream() 就失败
  • 建议先保护:Optional.ofNullable(list).filter(Collection::isEmpty).isPresent()
  • 更实用:Optional.ofNullable(list).map(Collection::isEmpty).orElse(true) // list 为 null 时视为“空”

小结:统一习惯比炫技更重要

团队内应约定一种主流判空风格(如统一用 Objects.isNull + isEmpty),避免混用。不推荐为省一行代码牺牲健壮性;也不必过度封装——简单逻辑直接内联反而更易读。null 检查不是“冗余”,而是契约的一部分。