Collections.copy()用于将源列表元素复制到已有目标列表中，要求目标列表大小不小于源列表且可修改，否则抛出异常。

在Java中，Collections.copy() 方法用于将一个集合中的所有元素复制到另一个集合中。需要注意的是，这个方法并不是创建集合的副本，而是将源集合的元素逐个复制到目标集合的对应位置上，且目标集合必须已有足够的容量来容纳这些元素，否则会抛出 IndexOutOfBoundsException。

方法定义与参数说明

Collections.copy() 的方法签名如下：

public static void copy(List extends T> dest, List extends T> src)

• src：源列表，即要被复制的集合。
• dest：目标列表，接收复制内容的集合。

该方法要求两个参数都必须是 List 类型，不支持 Set、Map 等其他集合类型。

使用前提条件

调用 Collections.copy() 前必须满足以下条件：

立即学习“Java免费学习笔记（深入）”；

• 目标列表的大小（size）不能小于源列表的大小。
• 目标列表必须是可修改的（非只读）。
• 两个列表都不能为空（null），否则会抛出 NullPointerException。

常见错误示例：

List src = Arrays.asList("a", "b", "c");
List dest = new ArrayList();
Collections.copy(dest, src); // 抛出 IndexOutOfBoundsException

正确使用方式

为了确保目标列表有足够的空间，通常可以通过初始化时指定大小或先填充默认值来实现。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

示例代码：

List src = Arrays.asList("Apple", "Banana", "Orange");
List dest = new ArrayList(Arrays.asList("", "", "")); // 预设空位
Collections.copy(dest, src);
System.out.println(dest); // 输出: [Apple, Banana, Orange]

也可以使用 Arrays.asList 创建固定大小的列表：

List dest = Arrays.asList(new String[src.size()]);
Collections.copy(dest, src);

与集合克隆的区别

Collections.copy() 并不会自动扩展目标集合，也不会创建新集合。它只是把源列表的元素写入已存在的目标列表中。

如果你希望真正“复制”一个集合，更简单的方式是直接构造新列表：

List newList = new ArrayList(originalList);

这种方式更直观、安全，适用于大多数需要复制的场景。

基本上就这些。只要记住 Collections.copy() 是“填充已有列表”，而不是“创建副本”，就能避免常见错误。