Java ArrayList.ensureCapacity 怎样减少扩容次数

批量向 ArrayList 追加数据时，如果大致知道最终会放入多少元素，可以在写入前调用 ensureCapacity 提前设置容量下限。这样做的目标是减少内部数组在追加过程中的增量重分配，但它不会提前创建元素，也不会改变 size()。

官方地址：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/util/ArrayList.html#ensureCapacity(int)

最常见的写法是：新列表已知规模时用 new ArrayList(预计数量)；列表已经存在、还要追加一批数据时用 ensureCapacity(当前 size + 待追加数量)。不要把 capacity 当成已经可以通过下标访问的元素数量。

先分清 size 和 capacity

size 是列表中实际存在的元素个数，capacity 是内部数组当前能够容纳的元素数量。capacity 至少不小于 size；元素继续增加时，ArrayList 会自动扩容，但官方并不承诺具体的增长比例。

因此，下面这段代码调用 ensureCapacity(1000) 后，列表仍然是空的，不能直接执行 get(0)：

import java.util.ArrayList;

public class CapacityIsNotSize {
    public static void main(String[] args) {
        ArrayList names = new ArrayList();
        names.ensureCapacity(1000); // 只预留内部容量，不添加任何元素

        System.out.println(names.size()); // 仍然是 0
        names.add("Ada"); // 真正添加元素后，size 才会增加
    }
}

这正是它适合批量写入的原因：先准备承载空间，随后仍然通过 add 或 addAll 维护正常的列表语义。

知道总量时，优先在写入前预留

如果数据源已经给出了明确数量，最简单的是在构造器中传入初始容量。构造器适合“从零开始”的列表；如果列表已经创建，则使用 ensureCapacity 更直接。

import java.util.ArrayList;

public class BatchLoad {
    public static void main(String[] args) {
        int expected = 50_000;
        ArrayList records = new ArrayList();
        records.ensureCapacity(expected); // 为预计批量写入设置容量下限

        for (int i = 0; i 

如果列表永远只会追加很少元素，自动增长通常已经足够；预留容量主要服务于规模明确、批量较大或写入路径对分配抖动敏感的场景。

已有列表追加数据时怎样计算容量

已有列表追加一批数据时，容量下限应该覆盖“当前元素数 + 新数据量”。这一步只是在调用方法前给出预算，真正的元素仍由 addAll 写入。

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

public class AppendBatch {
    static  void appendBatch(ArrayList target, List incoming) {
        int required;
        try {
            required = Math.addExact(target.size(), incoming.size()); // 防止数量相加溢出
        } catch (ArithmeticException ex) {
            throw new IllegalArgumentException("批量大小超过 int 可表示范围", ex);
        }

        target.ensureCapacity(required); // 容量只需覆盖追加后的总元素数
        target.addAll(incoming); // 这一步才改变 size
    }
}

如果输入数量来自不可信的外部参数，还应在进入容量计算前设置业务上限。ensureCapacity 不是内存配额控制器，盲目把异常大的数字传进去，可能导致不必要的内存压力。

哪些写法不能混用

trimToSize 与 ensureCapacity 是相反方向的容量操作：前者把容量收缩到当前 size，后者把容量至少提高到指定下限。频繁在两者之间切换，会抵消预留容量的意义。

上线前用四个问题确认

1. 预计数量是否可靠？不可靠时是否设置了合理上限？
2. 代码传给 ensureCapacity 的是最终元素数量，而不是字节数或索引？
3. 是否误以为预留容量后可以直接按下标写入？
4. 批量完成后是否真的通过 add、addAll 让 size 增长？

总结来说，ensureCapacity 的价值在于把可预见的批量增长提前告诉 ArrayList。它可以减少增量重分配，但不改变列表元素语义，也不承诺一个固定的内部增长比例。围绕这三个边界使用，通常就能得到简单且可维护的容量优化。

相关问题

• ensureCapacity 会让 size 立即变大吗？不会，它只调整内部容量下限。
• 应该直接用很大的容量吗？不建议，容量估计应有业务依据并考虑内存压力。
• 什么时候用 trimToSize？列表基本不再增长且希望减少空余容量时再考虑。