Rust crate如何同时编译生成wasm库与二进制可执行文件

核心原因 #

问题本质是编译目标混淆：后端二进制需要基于你当前运行的系统原生目标编译，而wasm库需要单独指定wasm系列目标编译。如果普通cargo build时出现sys crate缺失，大概率是你全局或者项目内配置了默认编译目标为wasm32-unknown-unknown这类wasm目标，导致后端二进制也被编译到wasm环境，而wasm环境本身不支持系统级的sys crate实现。

具体修复步骤 #

• 第一步：检查全局~/.cargo/config.toml或者项目内.cargo/config.toml文件，删除其中default-target = "wasm32-unknown-unknown"这类默认指定wasm为目标的配置，恢复原生目标为默认编译目标。
• 第二步：你当前的Cargo.toml配置不需要修改：rlib类型的库会在编译原生二进制时被正常链接，cdylib类型的库会在编译wasm目标时输出符合要求的wasm库，完全满足你复用lib.rs逻辑的需求。
• 第三步：分开使用编译命令
  • 编译后端二进制：直接执行cargo build即可，此时会按原生目标编译所有代码，sys crate会正常编译链接，不会出现缺失问题。
  • 编译wasm库：手动指定目标即可，命令为cargo build --target wasm32-unknown-unknown，如果使用wasm-pack工具的话直接执行wasm-pack build即可，工具会自动处理目标和参数配置。

可选优化：特性隔离平台差异 #

如果你的lib.rs中存在仅后端可用的原生依赖（比如sys crate相关逻辑），可以通过特性开关隔离代码，避免wasm编译时报错：

1. 在Cargo.toml中添加特性配置：

[features]
default = ["native"]
native = []
wasm = []

2. 在lib.rs中给平台相关代码添加条件编译标记：

// 仅原生目标编译的代码
#[cfg(feature = "native")]
mod native_impl {
    use some_sys_crate::*;
    // 原生逻辑实现
}

// 仅wasm目标编译的代码
#[cfg(feature = "wasm")]
mod wasm_impl {
    // wasm侧兼容逻辑实现
}

3. 编译wasm时执行命令：cargo build --target wasm32-unknown-unknown --no-default-features --features wasm即可过滤掉原生依赖。

内容的提问来源于stack exchange，提问作者Sophon Aniketos