为什么你用 Java 中的 List 集合总是踩坑

在实际开发中，开发人员往往会遇到一些常见的陷阱，可能导致程序出现异常、性能下降或者逻辑错误。

在本文中，我们将深入探讨 Java List 集合中容易踩到的坑，并提供一些最佳实践来避免这些问题。

一：未初始化或空指针异常

在使用 List 之前，务必确保已经对 List 对象进行了初始化，否则可能会遇到空指针异常（NullPointerException）。

List list;
// 这里会抛出 NullPointerException
list.add("item"); 

解决方法是在使用 List 之前进行初始化：

List list = new ArrayList<>();
list.add("item");

二：忘记调用 add 方法导致列表为空

有时候，开发者会忘记向 List 中添加元素，导致最终 List 为空。这可能会导致程序逻辑错误，因为在使用 List 时期望获取元素时，会得到意料之外的结果。

List list = new ArrayList<>();
// 忘记添加元素

解决方法是在使用 List 之前确保已经添加了元素，或者在声明 List 时就初始化添加元素。

三：使用 == 进行列表比较

在 Java 中，用于比较对象的引用是否相同，而不是比较对象的内容是否相同。

因此，如果想要比较两个 List 中的元素是否相同，应该使用 equals() 方法而不是操作符。

List list1 = new ArrayList<>();
List list2 = new ArrayList<>();
// 添加元素到list1和list2

if (list1 == list2) {
// 错误的比较方式
}

if (list1.equals(list2)) {
// 正确的比较方式
}

四：并发修改异常

当一个线程正在遍历 List 集合，而另一个线程同时修改了这个集合的结构（例如增加、删除元素），就会抛出并发修改异常（ConcurrentModificationException）。这通常发生在使用迭代器（Iterator）遍历 List 时。

import java.util.ArrayList;
import java.util.List;

public class ConcurrentModificationExample {


    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("A");
        list.add("B");
        list.add("C");

        // 使用迭代器遍历集合
        for (String element : list) {
            System.out.println(element);
            // 在遍历过程中尝试修改集合结构
            // 这里会抛出ConcurrentModificationException
            list.remove("A"); 
        }
    }
}

输出结果

解决办法通常是使用 Iterator 的 remove 方法来进行删除操作，而不是使用 List 自身的 remove 方法。这样可以避免 ConcurrentModificationException 异常的发生。

以下是修改后的例子：

import java.util.ArrayList;
import java.util.List;

public class ConcurrentModificationExample {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("A");
        list.add("B");
        list.add("C");

        // 使用迭代器遍历集合
        Iterator<String> iterator = list.iterator();
        while (iterator.hasNext()) {
            String element = iterator.next();
            System.out.println(element);

            // 使用迭代器的remove方法删除元素
            if(element.equals("A")){
                iterator.remove();
            }
            
        }

        System.out.println("移除后："+list);
    }
}

输出结果

五：不正确地使用 subList

subList(int fromIndex, int toIndex) 方法用于获取原列表的一个子列表，但需要注意的是，返回的子列表是原列表的一个视图，对子列表的修改会影响原列表，反之亦然。

因此，如果在对原列表进行结构性修改（如增加或删除元素）后再操作子列表，可能会导致程序出现异常。

List list = new ArrayList<>();
list.add("a");
list.add("b");
list.add("c");

List subList = list.subList(0, 2);
subList.add("d");
//输出 4
System.out.println(list.size());

解决方法是在对子列表进行操作之前，先将其转换为一个新的 ArrayList：

List list = new ArrayList<>();
list.add("a");
list.add("b");
list.add("c");

List subList = new ArrayList<>(list.subList(0, 2));
subList.add("d");
//输出 3
System.out.println(list.size());

六：忽略重写 equals 和 hashCode 方法

当自定义类的对象存储在 List 中，并且需要使用 contains、indexOf 等方法来查找对象时，一定要注意重写类的 equals 和 hashCode 方法。

如果不重写这两个方法，List 将使用默认的 equals 方法来比较对象的引用，而不是对象的内容，这可能会导致无法正确查找对象。

七：性能问题

在频繁对 List 进行增删操作时，使用 LinkedList 可能比 ArrayList 更高效，因为 LinkedList 的插入和删除操作的时间复杂度为O(1)，而 ArrayList 的时间复杂度为O(n)。

当需要频繁随机访问元素时，ArrayList 的性能更好，因为它的时间复杂度为 O(1)，而 LinkedList 的时间复杂度为 O(n)。

通过避免以上列举的坑，开发者可以更加安全和高效地使用 Java 中的 List 集合。

除了以上提到的问题，开发者在使用 List时应该根据具体情况选择合适的集合实现类，并且注意线程安全性和性能问题。

对 List 的深入理解和正确使用，将有助于提高Java应用程序的质量和性能。