吝啬每一 KB：wasm-pack 自动生成代码 vs 手动 WebIDL 绑定的体积博弈

在 WebAssembly (Wasm) 的生产实践中，开发者往往会面临一个悖论：为了追求极致性能而选择 Rust/Wasm，却发现 wasm-pack 生成的产物中，那个名为 _bg.js 的胶水文件体积超乎想象。

特别是当你仅仅想调用一个简单的 console.log 或者操作一下 DOM 时，wasm-bindgen 引入的运行时支撑可能会让你的首屏加载预算瞬间报警。本文将深度拆解 wasm-pack 生成的胶水代码与手动 WebIDL 绑定的二进制大小差异，并探讨其背后的架构成本。

1. wasm-pack (wasm-bindgen) 的“全家桶”逻辑

wasm-pack 的核心是 wasm-bindgen。它的设计哲学是**“零摩擦互操作”**。为了让 Rust 的 String、Result、Closure 能与 JavaScript 的对象无缝衔接，它在幕后做了大量工作：

• 内存映射机制：Wasm 只能理解数字（i32, f64等）。wasm-bindgen 生成了一套复杂的索引表，将 JS 对象存储在数组中，通过索引传递给 Wasm。
• 字符串编码：Rust 使用 UTF-8，JS 使用 UTF-16。胶水代码包含了一套成熟的 TextEncoder/TextDecoder 封装，以及处理内存增长（Memory Growth）的逻辑。
• 异常捕获：为了防止 Wasm panic 导致 JS 环境崩溃，它会自动生成大量封装层来处理错误栈。

体积代价：
即使是一个简单的 "Hello World"，wasm-bindgen 生成的 JS 胶水代码通常也在 10KB - 20KB（未压缩）左右。这部分代码是相对固定的“基准载荷”。

2. 手动 WebIDL 绑定的“极简主义”

手动绑定通常指跳过 wasm-bindgen 的高级抽象，直接使用 Rust 的 extern "C" 块，并配合极简的 JS 垫片。

手动方式的典型实现：

// Rust 端
extern "C" {
    fn log_snippet(ptr: *const u8, len: usize);
}

pub fn custom_log(s: &str) {
    unsafe { log_snippet(s.as_ptr(), s.len()); }
}

// JS 端
const importObject = {
    env: {
        log_snippet: (ptr, len) => {
            const buf = new Uint8Array(wasm.memory.buffer, ptr, len);
            console.log(new TextDecoder().decode(buf));
        }
    }
};

体积优势：
在这种模式下，JS 胶水代码几乎为零（仅取决于你手写的几行），而 Wasm 端的导入表（Import Table）也极度干净。对于小型库，这种方式可以将总体积压缩到 1KB - 2KB 以内。

3. 数据对比：自动化 vs 手动

在典型场景下（以一个包含 5 个常用 Web API 调用的工具库为例），两者的差异如下：

4. 为什么 wasm-bindgen 会导致 Wasm 二进制膨胀？

除了 JS 端的代码，wasm-bindgen 也会影响 Wasm 本身的体积：

1. Monomorphization (单态化)：为了处理 JS 类型的转换，Rust 编译器会生成大量的泛型展开代码。
2. 辅助函数：诸如 __wbindgen_malloc 和 __wbindgen_realloc 会被强制引入，即使你的业务逻辑可能并不频繁需要动态分配。
3. 元数据：wasm-bindgen 会在 Wasm 自定义段（Custom Sections）中插入大量元数据，用于在运行时描述接口定义（虽然可以用 wasm-opt 去除，但默认产物较大）。

5. 什么时候该抛弃 wasm-pack？

虽然 wasm-pack 是行业标准，但在以下场景，手动绑定或轻量级替代方案（如 wee_alloc 配合原始绑定）更具优势：

• 极小尺寸的嵌入式插件：如 Edge Functions（边缘计算）、微型图片处理器。
• 库的导出者：如果你正在编写一个供他人使用的 NPM 包，且该包功能单一，手动编写几行胶水代码可以显著降低下游用户的负担。
• 极致追求 TTI (Time to Interactive)：在弱网环境下，多出的 10KB JS 可能会造成可见的解析延迟。

结论

wasm-pack 生成的代码是**“为了通用性而牺牲体积”**的典型。它为开发者屏蔽了复杂的跨语言内存管理。然而，如果你追求的是极致的二进制精简，理解 WebIDL 的底层原理并手动构建导入对象，往往能获得 5-10 倍的体积缩减。

建议：中大型项目坚持使用 wasm-pack，小型工具库尝试 manual extern C。毕竟，最好的优化是不写不需要的代码。