system.arraycopy 是 jvm 用本地代码实现的高效数组复制方法,不创建新数组,参数需全部合法,否则抛出异常,复制前校验索引边界。

System.arraycopy 是 Java 中用于高效复制数组片段的底层方法,它不创建新数组,而是直接在内存层面移动数据,由 JVM 用本地代码(如 C/C++)实现,因此性能远高于手动 for 循环。
核心参数与作用逻辑
调用形式为:System.arraycopy(src, srcPos, dest, destPos, length),五个参数必须全部合法,否则抛 ArrayIndexOutOfBoundsException 或 NullPointerException。
- src:源数组(不能为 null)
- srcPos:源数组起始索引(>= 0,且
- dest:目标数组(不能为 null,类型需与 src 兼容)
- destPos:目标数组起始索引(>= 0,且
- length:要复制的元素个数(>= 0;若为 0,直接返回,不校验边界)
实际复制时,JVM 会检查:srcPos + length 且 <code>destPos + length ,任一不满足即抛异常。
支持同数组内复制(即“原地迁移”)
当 src == dest 时,System.arraycopy 能正确处理重叠区域,自动选择从前向后或从后向前复制,避免数据覆盖错误。
- 若
srcPos (目标起始在源起始右侧),则从末尾开始倒序复制,防止已复制数据被后续覆盖 - 若
srcPos >= destPos(目标起始在源起始左侧或相同),则正序复制
例如:将 int[] arr = {1,2,3,4,5} 中索引 1~3 的元素(即 2,3,4)移到索引 2 开始位置:System.arraycopy(arr, 1, arr, 2, 3);
结果为 {1,2,2,3,4} —— 正确完成“右移”且无中间污染。
类型兼容性与运行时检查
该方法支持基本类型和引用类型,但要求 src 和 dest 元素类型兼容:
- 基本类型数组之间必须完全一致(int[] → int[] 可,int[] → long[] 不可)
- 引用类型数组允许子类 → 父类(如 String[] → Object[]),但不允许父类 → 子类(Object[] → String[] 会抛 ArrayStoreException)
- 复制过程不进行元素级转型,只做内存块搬运
常见误用与规避建议
实际使用中容易踩坑的地方:
- 误把
length当作“结束索引”,应是“元素个数”(如复制索引 2 到 4 的元素,length 应为 3,不是 4) - 忽略 null 检查 —— src 或 dest 为 null 会立即抛 NullPointerException
- 跨类型赋值未验证 —— 如 Object[] 向 String[] 复制前,应确保每个元素实际是 String 实例
- 期望返回新数组 —— 它没有返回值(void 方法),所有操作都在 dest 数组上原地生效
不复杂但容易忽略。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











