那些能够直接编译到 WebAssembly 的 Rust Crates-CSDN博客

本文链接：https://blog.csdn.net/weixin_43114209/article/details/147296080

一、为什么有的 Crate “跑不起来”？

在最常见的 浏览器环境 中，Wasm 沙盒本身缺少操作系统功能和标准 C 运行时支持。以下几类依赖若出现在 crate 中，就很可能导致编译或运行时出错：

C / 系统库绑定
- 浏览器环境没有 libc、dlopen、pthread 等底层系统功能。
- 常见示例：openssl-sys、libz-sys、rocksdb-sys。
文件系统 I/O
- Wasm 未原生暴露文件系统；调用 std::fs::File::open 会直接 panic 或链路错误。
- 除非你依赖 WASI 或手动挂载虚拟 FS，否则尽量避免。
线程 / 原生同步
- std::thread::spawn 在 wasm32-unknown-unknown 上会 panic（trap）。
- parking_lot 默认开启线程锁；rayon 无特别 polyfill 时无法并行执行。
阻塞网络或套接字 I/O
- 浏览器中只能通过 fetch、WebSocket 等异步接口访问网络；原生 TcpStream 不可用。

二、哪些 Crate 通常「开箱即用」？

1. 纯算法与数据结构

为什么： 只依赖内存与 CPU 运算，无需 OS 支持。

hashbrown：高性能哈希表实现
smallvec：内联容量优化的可变长度数组
bitvec：位级向量与位操作
indexmap：保持插入顺序的哈希映射

// 示例：在 Wasm 中只需简单添加依赖即可使用 smallvec
use smallvec::SmallVec;

#[wasm_bindgen]
pub fn make_vec() -> SmallVec<[u8; 4]> {
    let mut v: SmallVec<[u8; 4]> = SmallVec::new();
    v.extend_from_slice(&[1, 2, 3]);
    v
}

2. `#![no_std]`／嵌入式友好 Crate

为什么： 无 std 运行时依赖，天然可在没有 OS 的环境下编译。

heapless：定容容量队列、映射、字符串
embedded-hal 及其上层驱动库
cortex-m 等 MCU 生态库

只要关闭默认特性，几乎无需额外改动：

[dependencies.heapless]
version = "0.7"
default-features = false
features = ["const-fn"]

3. 解析器（Parsers）

为什么： 只读取内存中的字节流/字符串，无 I/O 交互。

nom：零拷贝解析组合子
serde_json：JSON 序列化/反序列化（启用 alloc，关闭 std）
xml-rs（注意默认 std，可手动禁用）

# 举例：为 serde_json 启用 alloc 支持
cargo add serde_json --no-default-features --features alloc

4. 文本处理

为什么： 操作字符串、正则、Unicode 分词等都只依赖 CPU。

regex：正则表达式（需启用 regex-onig 或默认特性）
unicode-segmentation：Unicode 文本分词
once_cell：懒初始化单例

如需更小的体积，可切换到 regex-lite。

5. Rust 编程模式与工具

为什么： 编译期宏与纯算法，不触及运行时系统调用。

bitflags, derive_more, thiserror
proc-macro2, quote, syn（仅在构建时使用）

这些 crate 在 Wasm 编译期间生效，生成的运行时代码纯粹由你的业务逻辑决定。

三、如何快速验证一个 Crate 是否可用？

查看 Cargo.toml
- 是否有 links = "..."？
- 是否有 default-features = true 且内含 std？

尝试编译目标

rustup target add wasm32-unknown-unknown
cargo build --target wasm32-unknown-unknown --no-default-features

若编译通过，基本可“开箱即用”。

查依赖树
```
cargo tree -e features -i crate_name
```
识别哪些依赖引入了不兼容特性，然后通过 default-features = false 或 features = [...] 关闭。

四、总结

避雷：C ABI、文件 I/O、本地线程、阻塞网络。
首选：纯算法/数据结构、#![no_std] 嵌入式库、纯解析器、文本处理、编译期宏。
原则：先 cargo build --target wasm32-unknown-unknown，再根据错误信息关闭或替换不兼容依赖。

只要遵循上述思路，绝大多数 Rust crate 都能在浏览器侧 Wasm 环境中 无需重写 地直接使用，让你快速将熟悉的生态搬上 WebAssembly，享受更高性能与安全保证。祝你在 Wasm 世界开发顺利！