如何利用structuredClone拷贝包含GPUBuffer的原始WebGPU资源对象

不能使用 structuredClone() 拷贝包含 GPUBuffer 的 WebGPU 资源对象，因其属不可序列化的宿主对象，调用会抛出 DataCloneError；需手动重建配置并显式复制数据。

不能使用 structuredClone() 拷贝包含 GPUBuffer 的原始 WebGPU 资源对象。

structuredClone() 不支持 WebGPU 对象

structuredClone() 仅支持可序列化的标准 JavaScript 类型（如 Object、Array、Map、Set、Date、RegExp、ArrayBuffer 及其视图等）。WebGPU 接口对象（如 GPUBuffer、GPUTexture、GPUBindGroup 等）是平台绑定的宿主对象，没有内置的结构化克隆算法支持，也不在 HTML 规范的可克隆类型列表中。

尝试对含 GPUBuffer 的对象调用 structuredClone() 会直接抛出 DataCloneError 异常：

Uncaught DataCloneError: Failed to execute 'structuredClone' on 'Window': GPUBuffer object could not be cloned.

WebGPU 资源本质不可“拷贝”——需显式创建

WebGPU 中的资源（如 GPUBuffer）代表 GPU 内存句柄或驱动层对象，不是普通数据容器。它们不保存“值”，而是指向底层 GPU 分配。因此：

• 不存在“浅拷贝”或“深拷贝”的语义；
• 复制资源必须通过 WebGPU API 显式调用（如 device.createBuffer()）；
• 内容数据（如 buffer 数据）需单独用 queue.writeBuffer() 或映射写入；
• 无法通过 JS 层操作复制其状态（如 usage、mappedAtCreation、label 等元信息需手动重建）。

替代方案：手动重建 + 数据迁移

若需“等效副本”，应拆解为两步：

• 重建资源描述：提取原 GPUBuffer 的 size、usage、mappedAtCreation、label 等配置，调用 device.createBuffer() 创建新实例；
• 同步内容数据：
  • 若原 buffer 可读（GPUBufferUsage.COPY_SRC），用 commandEncoder.copyBufferToBuffer() 复制到新 buffer；
  • 若在 CPU 可访问（如已映射或用 queue.writeBuffer() 写入过），先读取（buffer.mapAsync() + getMappedRange()），再写入新 buffer；
  • 避免跨上下文共享 buffer —— WebGPU 不支持 buffer 句柄传递（如 postMessage 传递 GPUBuffer 本身无效）。

注意跨 Worker 或 iframe 的资源传递限制

即使使用 transferable 机制（如 postMessage(..., [arrayBuffer])），GPUBuffer 本身不可转移。目前 WebGPU 不提供类似 OffscreenCanvas 或 ImageBitmap 的可转移资源类型。所有 GPU 资源必须在创建它的同一 GPUDevice 所属上下文中使用。

如需多线程协作，只能传递描述信息（JSON）和二进制数据（ArrayBuffer），由目标线程用本地 GPUDevice 重建资源并载入数据。