Java ArrayList add() 方法（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Java 编程中，集合框架是开发者日常开发中高频使用的工具之一。其中，ArrayList 作为动态数组的典型实现，因其灵活性和易用性，成为许多开发者处理数据存储和操作的首选。而 add() 方法作为 ArrayList 的核心操作之一，掌握其原理与使用细节，能够帮助开发者更高效地完成代码编写，并避免潜在的性能问题。本文将从基础概念出发，结合代码示例与实际案例，深入解析 ArrayList add() 方法的实现逻辑、使用场景及注意事项，帮助读者全面理解这一重要方法。

一、ArrayList 的基本概念与特性

1.1 什么是 ArrayList？

ArrayList 是 Java 集合框架中 List 接口的动态数组实现类。它允许存储一组有序且可重复的元素，其底层通过动态数组实现，能够自动扩容以适应元素数量的变化。

形象比喻：
可以将 ArrayList 想象成一个可伸缩的书架。最初书架可能只有 10 个书格，当放入第 11 本书时，书架会自动扩展为更大的容量（例如 15 个书格），而开发者无需手动干预这一过程。

1.2 ArrayList 的核心特性

• 动态数组：容量随元素数量增长自动调整。
• 有序性：元素按插入顺序存储，支持通过索引快速访问。
• 非线程安全：多线程环境下需配合同步机制或使用 CopyOnWriteArrayList。
• 允许 null 值和重复元素：与 List 接口一致。

二、add() 方法的语法与基本用法

2.1 方法签名

ArrayList 提供了两个重载的 add() 方法：

// 在列表末尾添加元素  
boolean add(E e);  

// 在指定索引位置插入元素  
void add(int index, E element);  

2.2 添加元素到末尾

这是最常用的场景。例如：

ArrayList<String> books = new ArrayList<>();  
books.add("Java 核心编程");  
books.add("算法导论");  
System.out.println(books); // 输出: [Java 核心编程, 算法导论]  

返回值说明：add(E e) 返回 boolean 类型，总是返回 true，因为 ArrayList 允许所有元素添加操作。

2.3 在指定位置插入元素

通过 add(index, element) 可以在列表的任意位置插入元素。例如：

ArrayList<String> fruits = new ArrayList<>();  
fruits.add("苹果");  
fruits.add("香蕉");  
fruits.add(1, "橙子"); // 在索引 1 的位置插入  
System.out.println(fruits); // 输出: [苹果, 橙子, 香蕉]  

注意事项：

• 若索引超出有效范围（如小于 0 或大于当前元素数量），会抛出 IndexOutOfBoundsException。
• 插入操作会导致后续元素的索引自动后移。

三、深入理解 add() 方法的底层实现

3.1 动态扩容机制

ArrayList 的底层是一个对象数组。当调用 add() 方法时，若当前数组容量不足，会触发扩容操作。

3.1.1 扩容逻辑详解

扩容的核心逻辑如下：

if (elementData.length < size + 1) {  
    // 计算新容量：原容量 * 1.5 + 1  
    int newCapacity = elementData.length * 3 / 2 + 1;  
    // 若新容量不足最小容量要求，则取最小容量  
    if (newCapacity < minCapacity)  
        newCapacity = minCapacity;  
    // 创建新数组并复制旧数据  
    elementData = Arrays.copyOf(elementData, newCapacity);  
}  

关键点解释：

• 扩容系数：默认扩容为原容量的 1.5 倍（加 1 是为避免整数除法误差）。
• 性能影响：频繁扩容会导致额外的内存分配和数据拷贝，因此建议通过 ArrayList(int initialCapacity) 初始化时指定初始容量。

3.1.2 扩容的性能优化

假设初始容量为 10，依次添加 15 个元素：

1. 第 11 个元素触发扩容：新容量为 10 * 3/2 + 1 = 16。
2. 第 17 个元素时，新容量为 16 * 3/2 + 1 = 25。

优化建议：

• 若已知元素总数，初始化时直接指定容量（如 new ArrayList<>(预计元素数量)），可避免多次扩容。
• 若元素数量波动大，1.5 倍的扩容策略已能平衡内存与性能。

四、使用 add() 方法的常见场景与案例

4.1 场景 1：动态收集数据

在循环中动态添加元素是典型用法：

ArrayList<Integer> numbers = new ArrayList<>();  
for (int i = 0; i < 10; i++) {  
    numbers.add(i);  
}  
System.out.println(numbers); // 输出: [0, 1, 2, ..., 9]  

4.2 场景 2：在指定位置插入元素

例如，维护一个待办事项列表，需在指定位置插入新任务：

ArrayList<String> tasks = new ArrayList<>();  
tasks.add("完成项目文档");  
tasks.add("修复 Bug");  
tasks.add(1, "召开需求评审会"); // 插入到第二个位置  
System.out.println(tasks); // 输出: [完成项目文档, 召开需求评审会, 修复 Bug]  

4.3 场景 3：结合其他集合操作

与 addAll()、remove() 等方法结合使用：

ArrayList<String> list1 = new ArrayList<>(Arrays.asList("A", "B"));  
ArrayList<String> list2 = new ArrayList<>(Arrays.asList("C", "D"));  
list1.addAll(1, list2); // 在索引 1 处插入 list2 的所有元素  
System.out.println(list1); // 输出: [A, C, D, B]  

五、使用 add() 方法的注意事项与异常处理

5.1 索引越界异常

若插入位置超出当前列表范围，会抛出 IndexOutOfBoundsException：

ArrayList<String> list = new ArrayList<>(Arrays.asList("Java", "Python"));  
try {  
    list.add(3, "Go"); // 索引 3 超过当前元素数量 2  
} catch (IndexOutOfBoundsException e) {  
    System.out.println("索引无效: " + e.getMessage());  
}  

5.2 并发修改问题

在遍历列表时直接调用 add() 方法可能导致 ConcurrentModificationException：

ArrayList<String> list = new ArrayList<>(Arrays.asList("A", "B"));  
for (String item : list) {  
    if (item.equals("B")) {  
        list.add("C"); // 此处会抛出异常  
    }  
}  

解决方案：

• 使用迭代器的 add() 方法：

  Iterator<String> iterator = list.iterator();  
  while (iterator.hasNext()) {  
      String item = iterator.next();  
      if (item.equals("B")) {  
          iterator.add("C"); // 安全添加  
      }  
  }  
  

5.3 性能优化建议

• 避免频繁插入中间位置：中间插入需要移动后续元素，时间复杂度为 O(n)。
• 初始化时预估容量：减少扩容次数。

六、对比其他集合的 add() 方法

6.1 与 LinkedList 的对比

适用场景：

• 需频繁遍历和随机访问时，优先选择 ArrayList；
• 需频繁在中间插入/删除元素时，选择 LinkedList。

七、总结与扩展学习

7.1 核心要点回顾

1. ArrayList 的 add() 方法支持末尾添加和指定位置插入。
2. 动态扩容机制通过 1.5 倍策略平衡内存与性能。
3. 注意索引越界和并发修改问题。

7.2 进阶学习方向

• 源码分析：深入阅读 ArrayList 的 add() 和扩容实现代码。
• 集合框架对比：学习 Vector（线程安全的 ArrayList）、CopyOnWriteArrayList 等变体。
• 性能调优：结合实际场景优化集合操作，例如使用 Arrays.asList() 或 Collections.singletonList()。

通过本文的学习，读者应能全面掌握 ArrayList add() 方法的使用场景、实现原理及常见问题解决方案。建议结合实际项目中的数据操作需求，进一步实践和优化代码逻辑。

推荐阅读：若对集合框架有更深层次的兴趣，可阅读《Effective Java》中关于集合章节的分析，或查阅官方文档了解 ArrayList 的历史版本差异。