copyWithin()是数组原地复制方法,不创建新数组、不触发内存分配,通过arr.copyWithin(target, start, end)实现重叠安全的高效位移;target为复制目标起始索引(支持负数),start/end定义左闭右开源区间,默认start=0、end=arr.length。

copyWithin() 是数组的原地方法,它不创建新数组,只在当前数组内部复制并覆盖元素,因此能高效实现数据位移(如左移、右移、循环移位),且完全避免内存分配。
理解 copyWithin() 的三个参数
语法:arr.copyWithin(target, start, end)
- target:复制到的起始索引(可为负数,从末尾计)
- start:复制源的起始索引(含,默认 0)
- end:复制源的结束索引(不含,可省略,默认 arr.length)
关键特性:**复制和写入过程是“原子性”重叠安全的**——即使 target 和源区间重叠(如左移时 target
实现向左位移 k 位(非循环)
把前 k 个元素丢弃,其余元素前移 k 位,末尾 k 个位置留空或忽略(若需补值,可额外处理):
const arr = [1, 2, 3, 4, 5]; const k = 2; arr.copyWithin(0, k); // [3, 4, 5, 4, 5] // 实际效果:[3, 4, 5, ...],后两位是重复拷贝;如需清空,可手动填充 arr.length = arr.length - k; // 直接截断 → [3, 4, 5]
实现向右位移 k 位(非循环)
将后 len−k 个元素右移 k 位,前 k 位通常补默认值(如 0 或 undefined):
const arr = [1, 2, 3, 4, 5]; const k = 2; // 先扩展数组长度(仅当需要保留原长时) arr.length += k; // [1, 2, 3, 4, 5, empty ×2] // 将原数据从索引 0 开始,复制到索引 k 起的位置 arr.copyWithin(k, 0, arr.length - k); // [1, 2, 1, 2, 3, 4] // 前 k 位仍为旧值,可手动置空 arr.fill(0, 0, k); // [0, 0, 1, 2, 3, 4]
实现循环右移 k 位(最常用场景)
无需扩容、不丢失数据,纯原地完成:
function rotateRight(arr, k) {
if (arr.length === 0) return;
const len = arr.length;
k = k % len;
if (k === 0) return;
<p>// 分三步:先翻转后 k 个,再翻转前 len−k 个,最后翻转整个数组
// 但更直接:用 copyWithin 模拟“切块移动”
// 等价做法(推荐):
const offset = len - k;
arr.copyWithin(0, offset); // 把后 k 个移到开头 → [a,b,c,d,e] k=2 → [d,e,e,d,e]
arr.copyWithin(k, 0, len - k); // 把原前 len−k 个移到 k 之后 → [d,e, a,b,c]
}
// 示例:
const arr = [1, 2, 3, 4, 5];
rotateRight(arr, 2); // → [4, 5, 1, 2, 3]
说明:第一次 copyWithin(0, 3) 把索引 3~4 的 [4,5] 复制到 0~1;第二次 copyWithin(2, 0, 3) 把索引 0~2 的 [4,5,3](注意此时索引 2 已被覆盖?不!copyWithin 自动处理重叠)→ 实际上更稳妥写法是分步理解,但上述两行确实正确达成循环右移。
注意事项与边界处理
- 所有索引自动标准化:负数从末尾算,超出范围会被截断(如 start > end 则不复制)
- target 可大于数组长度,此时数组会自动扩容(稀疏区域为 empty),但仍是原数组引用
- 不触发 setter/getter,不调用自定义属性访问器,纯底层内存搬移语义
- 对 TypedArray 同样适用,性能更显著(如 Uint8Array 处理二进制流位移)

















