System.arraycopy是JVM底层内存搬运指令,参数顺序固定为(src, srcPos, dest, destPos, length),任一错误均运行时抛异常;支持截取、拼接及同一数组内安全移位,但需手动校验边界与类型兼容性。

System.arraycopy 不是普通复制函数,而是 JVM 底层的内存块搬运指令。它快,因为跳过 Java 层循环和逐元素检查;它严,因为五个参数任一出错,运行时立刻抛异常——不警告、不静默修复,全靠你写对。
五个参数各管什么
方法签名固定:System.arraycopy(src, srcPos, dest, destPos, length),顺序不能错,缺一不可:
- src:源数组对象,不能为空,否则抛 NullPointerException
- srcPos:从源数组第几个索引开始读(从 0 起),必须 ≥ 0,且 srcPos + length ≤ src.length,否则越界
- dest:目标数组对象,也不能为空;类型需与 src 兼容(如 String[] 可拷到 Object[],但 Integer[] 不可接收 String[])
- destPos:往目标数组第几个索引开始写,必须 ≥ 0,且 destPos + length ≤ dest.length
- length:要复制的元素个数,必须 ≥ 0;为 0 时合法(空操作),为负数则抛 NegativeArraySizeException
截取与拼接的实用写法
arraycopy 本身不创建新数组,所以“截取”需配合 new 分配目标空间,“拼接”需分步控制写入位置:
- 从
int[] arr截取索引 [2, 5)(即第 2、3、4 位)→int[] dst = new int[3]; System.arraycopy(arr, 2, dst, 0, 3); - 拼接两个数组
a和b→ 先算总长:int[] result = new int[a.length + b.length];,再两步搬运:System.arraycopy(a, 0, result, 0, a.length);和System.arraycopy(b, 0, result, a.length, b.length); - 处理不确定长度时,建议预校验:
int len = Math.min(100, arr.length - offset);,再传入len避免崩溃
同一数组内移动:JVM 自动保安全
当 src == dest,就是原地移位。JVM 会根据 srcPos 和 destPos 的大小关系,自动选择正向或倒序搬运,防止覆盖:
立即学习“Java免费学习笔记(深入)”;
-
左移(destPos < srcPos):如
System.arraycopy(arr, 3, arr, 1, 3)→ 从索引 3 开始的 3 个元素,整体前移到索引 1 起,JVM 正向执行 -
右移(destPos > srcPos):如
System.arraycopy(arr, 1, arr, 4, 3)→ 从索引 1 开始的 3 个元素,后移到索引 4 起,JVM 倒序搬运,先搬高位再覆盖低位 -
重叠区间合法,但边界仍需手动校验:确保
srcPos + length ≤ arr.length且destPos + length ≤ arr.length
避坑要点:运行时才校验,错就崩
编译器不检查类型兼容性,所有校验都在运行时触发:
- 基本类型数组严格区分:
int[]拷到long[]直接抛 ArrayStoreException - 引用类型按继承链判断:
String[]可拷到Object[],反过来不行 - 目标数组长度不足、起始索引为负、length 导致越界 → 统一抛 ArrayIndexOutOfBoundsException
- 小数组(如长度 ≤ 16)用 for 循环反而更快;真正发挥优势的是大数组(基本类型 ≥ 256)、已预分配目标空间、类型匹配的场景


















