java list.addAll介绍

java.util.List接口的addAll()方法用于将一个集合的所有元素添加到列表中。这个方法有两个重载版本：

1. 方法签名

// 版本1：添加到列表末尾 boolean addAll(Collection<? extends E> c) // 版本2：插入到指定位置 boolean addAll(int index, Collection<? extends E> c)

2. 参数说明

• c: 要添加的集合，其中的元素类型必须与列表元素类型兼容

• index（仅版本2）：插入位置的索引（从0开始）

3. 返回值

• 如果列表因调用而改变，返回true

• 否则返回false

4. 基本用法示例

示例1：添加到末尾

List<String> list1 = new ArrayList<>(Arrays.asList("A", "B", "C")); List<String> list2 = new ArrayList<>(Arrays.asList("D", "E", "F")); // 将list2的所有元素添加到list1末尾 list1.addAll(list2); // 结果: ["A", "B", "C", "D", "E", "F"]

示例2：插入到指定位置

List<String> list1 = new ArrayList<>(Arrays.asList("A", "D")); List<String> list2 = new ArrayList<>(Arrays.asList("B", "C")); // 在索引1处插入list2的元素 list1.addAll(1, list2); // 结果: ["A", "B", "C", "D"]

5. 实际应用场景

场景1：合并多个列表

List<Integer> result = new ArrayList<>(); List<Integer> part1 = Arrays.asList(1, 2, 3); List<Integer> part2 = Arrays.asList(4, 5, 6); List<Integer> part3 = Arrays.asList(7, 8, 9); result.addAll(part1); result.addAll(part2); result.addAll(part3); // result: [1, 2, 3, 4, 5, 6, 7, 8, 9]

场景2：批量添加初始化数据

List<String> tasks = new ArrayList<>(); tasks.add("Task 1"); tasks.addAll(Arrays.asList("Task 2", "Task 3", "Task 4"));

场景3：列表插入操作

List<String> schedule = new ArrayList<>(Arrays.asList("Morning", "Evening")); List<String> afternoonTasks = Arrays.asList("Lunch", "Meeting"); // 在"Morning"后面插入下午的安排 schedule.addAll(1, afternoonTasks); // 结果: ["Morning", "Lunch", "Meeting", "Evening"]

6. 注意事项

1.集合为null时

List<String> list = new ArrayList<>(); list.addAll(null); // 抛出 NullPointerException

2.索引越界

List<String> list = new ArrayList<>(Arrays.asList("A", "B")); list.addAll(5, Arrays.asList("C", "D")); // 抛出 IndexOutOfBoundsException

3.修改被添加的集合

List<String> source = new ArrayList<>(Arrays.asList("A", "B", "C")); List<String> target = new ArrayList<>(); target.addAll(source); source.add("D"); // 不影响target System.out.println(target); // 输出: [A, B, C]

4.添加自身

List<String> list = new ArrayList<>(Arrays.asList("A", "B")); list.addAll(list); // 会导致无限循环，抛出 StackOverflowError

7. 与单个add()比较

// 使用 addAll() - 推荐 list1.addAll(list2); // 使用循环 add() - 不推荐 for (String item : list2) { list1.add(item); }

8. 与Java 8+ Stream结合

// 使用Stream合并多个列表 List<Integer> merged = Stream.of(list1, list2, list3) .flatMap(List::stream) .collect(Collectors.toList());

总结

addAll()是Java集合框架中一个非常实用的方法，它：

• 提供批量添加元素的功能

• 支持在指定位置插入集合

• 比循环添加更简洁高效

• 广泛应用于列表合并、批量初始化等场景

使用时需要注意处理null值和索引边界情况，避免常见的运行时异常。