在Java编程中,数组复制是经常会遇到的操作场景,比如需要保留原数组数据同时生成新数组、截取数组部分元素等情况。System.arraycopy是Java标准库中提供的一个原生数组复制方法,由底层C/C++实现,执行效率远高于普通的循环遍历复制方式,是处理数组复制场景的优选方案。

System.arraycopy方法基本定义
System.arraycopy是java.lang.System类中的静态本地方法,方法签名如下:
public static native void arraycopy(
Object src, // 源数组
int srcPos, // 源数组的起始复制位置
Object dest, // 目标数组
int destPos, // 目标数组的起始存放位置
int length // 需要复制的元素个数
);
该方法没有返回值,执行后会直接修改目标数组的内容,将源数组指定范围的元素复制到目标数组的对应位置。
基础使用示例
下面通过一个简单示例演示如何使用System.arraycopy复制数组:
public class ArrayCopyDemo {
public static void main(String[] args) {
// 定义源数组
int[] sourceArray = {1, 2, 3, 4, 5};
// 定义目标数组,长度需要和复制的元素数量匹配
int[] targetArray = new int[3];
// 从源数组索引1的位置开始,复制3个元素到目标数组的索引0位置
System.arraycopy(sourceArray, 1, targetArray, 0, 3);
// 输出目标数组内容
for (int num : targetArray) {
System.out.println(num);
}
}
}
上述代码执行后,会输出2、3、4,也就是源数组从索引1开始的三个元素被成功复制到了目标数组中。
不同数组类型的复制示例
System.arraycopy支持所有Java数组类型,包括引用类型数组,下面是复制字符串数组的示例:
public class StringArrayCopyDemo {
public static void main(String[] args) {
String[] source = {"Java", "Python", "C++", "Go"};
String[] dest = new String[2];
// 复制源数组前两个元素到目标数组
System.arraycopy(source, 0, dest, 0, 2);
for (String s : dest) {
System.out.println(s);
}
}
}
执行后输出Java和Python,说明引用类型数组也可以正常使用该方法复制。
性能对比:System.arraycopy vs 循环复制
为了直观展示两种复制方式的效率差异,我们编写测试代码对比复制100万长度数组的耗时:
public class PerformanceCompare {
public static void main(String[] args) {
int arrayLength = 1000000;
int[] source = new int[arrayLength];
// 初始化源数组
for (int i = 0; i < arrayLength; i++) {
source[i] = i;
}
int[] dest1 = new int[arrayLength];
int[] dest2 = new int[arrayLength];
// 测试循环复制耗时
long startTime1 = System.currentTimeMillis();
for (int i = 0; i < arrayLength; i++) {
dest1[i] = source[i];
}
long endTime1 = System.currentTimeMillis();
System.out.println("循环复制耗时:" + (endTime1 - startTime1) + "毫秒");
// 测试System.arraycopy复制耗时
long startTime2 = System.currentTimeMillis();
System.arraycopy(source, 0, dest2, 0, arrayLength);
long endTime2 = System.currentTimeMillis();
System.out.println("System.arraycopy复制耗时:" + (endTime2 - startTime2) + "毫秒");
}
}
多次执行测试代码可以发现,System.arraycopy的耗时通常只有循环复制的一半甚至更低,数组长度越大,性能优势越明显。
使用注意事项
- 源数组和目标数组必须是同类型的数组,或者存在继承关系,否则会抛出
ArrayStoreException异常。比如不能把int[]复制到String[]中。 - 所有索引和长度参数不能为负数,否则会抛出
IndexOutOfBoundsException异常。 - 复制的范围不能超过源数组和目标数组的长度,比如源数组长度是5,就不能从索引3开始复制3个元素,否则会抛出
IndexOutOfBoundsException异常。 - 如果源数组和目标数组是同一个数组,也可以正常复制,方法会正确处理重叠区域的元素,不会出现数据覆盖错误的问题。
- 该方法不会自动扩容目标数组,如果目标数组长度不足,会直接抛出异常,使用前需要确保目标数组有足够空间存放复制的元素。
常见问题解答
复制基本类型数组和引用类型数组有什么区别?
复制基本类型数组时,会直接复制元素的值;复制引用类型数组时,复制的是对象的引用地址,也就是复制后源数组和目标数组对应的元素会指向同一个对象,修改其中一个数组中的对象属性,另一个数组的对应元素也会受到影响。
可以用System.arraycopy复制多维数组吗?
可以,但需要注意多维数组本质是数组的数组,直接复制外层数组只会复制内层数组的引用,不会复制内层数组的元素,如果需要深拷贝多维数组,需要逐层调用System.arraycopy。
System.arraycopyJava数组复制数组操作高效复制修改时间:2026-06-30 19:57:33