TypedArray 深拷贝后 byteOffset 丢失是因为 structuredClone 等方法只复制数据内容，不保留视图与 ArrayBuffer 的结构关系，导致新视图 byteOffset 恒为 0。
TypedArray 的 byteOffset 在深拷贝后丢失原始 ArrayBuffer 偏移信息，是常见但隐蔽的 Bug。根本原因在于：标准深拷贝（如 structuredClone、JSON.parse(JSON.stringify()) 或多数第三方库）只复制数据内容，不保留视图与底层 ArrayBuffer 的结构关系——byteOffset 和 byteLength 依赖的“起始偏移”和“共享内存上下文”被彻底切断。
为什么深拷贝会丢掉 byteOffset？
TypedArray（如 Uint8Array、Float32Array）本身不存储数据，而是作为 ArrayBuffer 的“视图”。它的 byteOffset 是相对于该 ArrayBuffer 起始地址的偏移量（单位：字节）。深拷贝时：
- 多数实现会新建 ArrayBuffer 并复制数据内容，生成一个从 offset 0 开始的新视图；
- 原始视图的
byteOffset（比如 128）不会被记录或还原； - 拷贝后的 TypedArray 的
byteOffset恒为 0，即使你期望它仍是 128。
如何快速识别这个 Bug？
在关键路径加入轻量断言或日志，重点关注以下信号：
-
对比拷贝前后
byteOffset：若原值非 0，拷贝后变成 0，即中招； -
检查视图是否仍指向预期内存段：例如，原
new Uint8Array(buffer, 128, 64)表示“跳过前 128 字节读 64 字节”，拷贝后若变成new Uint8Array(newBuffer, 0, 64)，语义已改变； - 运行时行为异常但无报错：如解码协议头失败、图像/音频解析错位、WebGL 纹理上传黑屏——这些常因数据实际起始位置偏移被重置为 0 导致。
安全深拷贝 TypedArray 的正确做法
不依赖通用深拷贝函数，改用显式构造保持结构语义：
- 手动重建视图：const copied = new Uint8Array(original.buffer.slice(original.byteOffset, original.byteOffset + original.byteLength))；
- 若需真正隔离（避免共享 buffer），先
slice()再构造：new Uint8Array(original.buffer.slice(original.byteOffset, original.byteOffset + original.byteLength))； - 对多维或复合结构（如含多个 TypedArray 的对象），遍历并单独处理每个 TypedArray 字段，跳过自动递归拷贝；
- 使用支持底层内存语义的工具（如
ArrayBuffer.transfer配合structuredClone({ transfer: [...] })），但注意兼容性与所有权转移风险。
调试建议：加一层包装防护
在开发阶段可临时封装 TypedArray 构造逻辑，自动记录并校验 offset：
- 创建工厂函数
safeView(Ctor, buffer, byteOffset, length)，内部保存{ buffer, byteOffset, length }元数据； - 提供
.toClonedView()方法，返回正确带 offset 的新视图； - 在关键消费点（如解析器入口）加
console.assert(view.byteOffset === expectedOffset)。
