如何利用 BigInt 与 Int64Array 在 WebAssembly 中传递原始数据-js教程-PHP中文网

bigint不能直接用于webassembly内存传递，因wasm仅原生支持i32/i64，且js无int64array；可行方案是使用bigint64array共享内存视图，或序列化为uint8array配合大数库处理任意精度运算。

如何利用 bigint 与 int64array 在 webassembly 中传递原始数据

BigInt 本身不能直接用于 WebAssembly 的内存传递，Int64Array 也**不是标准 JavaScript 类型**，无法在 JS 和 Wasm 之间直接共享。WebAssembly 当前（Wasm MVP 及 WASI、Wasm GC 等扩展前）仅原生支持 i32 和 i64 整数类型，但 JavaScript 端的 Int64Array 并不存在 —— 浏览器尚未实现该类型（截至 2024 年所有主流引擎均不支持）。因此，“利用 BigInt 与 Int64Array 在 WebAssembly 中传递原始数据”这个说法存在根本性误解，需先厘清限制，再给出可行路径。

WebAssembly 不支持 BigInt 作为参数或返回值

Wasm 二进制格式和调用约定（如 WASI 或 JS API）不定义 BigInt 类型。即使你用工具链（如 Rust + wasm-bindgen 或 AssemblyScript）生成导出函数，其参数/返回值仍会被降级为 i32 或 i64。BigInt 是 JS 引擎层的高精度对象，无法映射到 Wasm 线性内存的固定字节布局中。

Wasm 函数签名只能含 i32、i64、f32、f64 和空（void）
JS 调用 Wasm 函数时传入 BigInt 会抛出 TypeError: cannot convert a BigInt to a number
Wasm 返回 i64 值，JS 接收后若超出 Number.MAX_SAFE_INTEGER（2⁵³−1），需手动转为 BigInt —— 但这是“读取后转换”，不是“传递 BigInt”

没有 Int64Array，可用 BigInt64Array 替代（但有兼容性与语义限制）

JavaScript 实际提供的是 BigInt64Array（ES2020 标准），它基于 ArrayBuffer，每个元素是 64 位有符号整数，底层存储为二进制补码。它可以与 Wasm 线性内存共享视图，是目前最接近“Int64Array”的合法方式。

BigInt64Array 只能操作 ArrayBuffer，不能直接 new 出独立实例；必须绑定到已分配的内存（如 Wasm 的 memory.buffer）
它与 Wasm 的 i64 内存布局完全一致（小端序、补码），可安全双向读写
注意：Safari 15.4+、Chrome 85+、Firefox 79+ 支持；旧版或部分 Node.js 版本可能不支持

正确做法：用 BigInt64Array 共享内存，配合 i64 导出函数交换 64 位整数

典型流程是：Wasm 分配内存 → JS 创建 BigInt64Array 视图 → JS 写入 BigInt 值（自动截断或补码转换）→ Wasm 函数以 i64 参数或内存偏移读取。

Wasm（Rust 示例）：

#[no_mangle]
    pub extern "C" fn process_i64_at(ptr: *mut i64) -> i64 {
        let val = unsafe { *ptr };
        val * 2 // 简单运算
    }

JS 端：

const wasmMem = wasm.instance.exports.memory;
    const view = new BigInt64Array(wasmMem.buffer);
<pre class="brush:php;toolbar:false;">// 写入一个大整数（自动转为 i64 补码）
view[0] = 9223372036854775807n; // 2⁶³−1

// 调用 Wasm 函数处理地址 0 处的 i64
const result = wasm.instance.exports.process_i64_at(0);

// result 是 JS number（可能精度丢失），如需完整 64 位，改用内存读取：
console.log(view[0]); // => -2n （溢出后补码结果）