Rust WebAssembly工具库wasm-tools的使用：高效解析、转换和操作WASM文件的Rust插件

安装

从源代码构建需先安装Rust，然后使用Cargo包管理器安装：

$ cargo install --locked wasm-tools

或者使用cargo binstall安装预编译版本：

$ cargo binstall wasm-tools

验证安装：

$ wasm-tools --version

查看子命令：

$ wasm-tools help

示例

基本验证/打印/解析

# 验证WASM文件
$ wasm-tools validate foo.wasm

# 转换文本格式模块为二进制
$ wasm-tools parse foo.wat -o foo.wasm

# 打印模块文本格式到stdout
$ wasm-tools print foo.wasm

# 将二进制模块转换为文本
$ wasm-tools print foo.wasm -o foo.wat

简单变异及命令组合

# 变异WASM模块并打印文本表示
$ wasm-tools mutate foo.wasm -t

# 使用非默认种子变异模块并验证输出
$ wasm-tools mutate foo.wasm --seed 192 | wasm-tools validate

# 解构Rust/C++符号名，去除自定义段
$ wasm-tools demangle foo.wasm | wasm-tools strip | wasm-tools objdump

组件相关操作

# 打印组件的WIT接口
$ wasm-tools component wit component.wasm

# 将核心WASM二进制转换为组件
$ wasm-tools component new my-core.wasm -o my-component.wasm

# 转换使用WASI的核心WASM二进制为组件
$ wasm-tools component new my-core.wasm -o my-component.wasm --adapt wasi_snapshot_preview1.reactor.wasm

Rust库示例代码

use wasm_tools::validate::validate_wasm;
use std::fs;

fn main() {
    // 读取WASM文件
    let wasm_bytes = fs::read("example.wasm").unwrap();
    
    // 验证WASM
    if validate_wasm(&wasm_bytes).is_ok() {
        println!("WASM文件验证通过");
    } else {
        println!("WASM文件验证失败");
    }
    
    // 解析WAT文本格式
    let wat = "(module)";
    let wasm = wasm_tools::parse::wat2wasm(wat).unwrap();
    
    // 打印WASM为文本格式
    let wat_output = wasm_tools::print::wasm2wat(&wasm).unwrap();
    println!("{}", wat_output);
}

完整示例demo

下面是一个更完整的wasm-tools使用示例，展示如何读取、验证、转换和修改WASM文件：

use wasm_tools::{validate::validate_wasm, parse::wat2wasm, print::wasm2wat};
use wasm_mutate::WasmMutate;
use std::{
    fs,
    path::Path,
    error::Error,
};

// 完整的WASM文件处理示例
fn process_wasm_file(input_path: &str, output_path: &str) -> Result<(), Box<dyn Error>> {
    // 1. 读取WASM文件
    let wasm_bytes = fs::read(input_path)?;
    println!("读取WASM文件: {} ({}字节)", input_path, wasm_bytes.len());

    // 2. 验证WASM文件
    validate_wasm(&wasm_bytes)?;
    println!("WASM验证通过");

    // 3. 转换为文本格式(WAT)
    let wat_string = wasm2wat(&wasm_bytes)?;
    println!("转换后的WAT文本格式:");
    println!("{}", wat_string);

    // 4. 变异WASM模块
    let mut config = WasmMutate::default();
    config.seed(42); // 设置随机种子
    let mutated_wasm = config.run(&wasm_bytes)?;
    println!("生成变异后的WASM ({}字节)", mutated_wasm.len());

    // 5. 保存变异后的WASM
    fs::write(output_path, &mutated_wasm)?;
    println!("已保存变异WASM到: {}", output_path);

    Ok(())
}

fn main() {
    if let Err(e) = process_wasm_file("input.wasm", "output.wasm") {
        eprintln!("处理WASM文件出错: {}", e);
    }
}

包含的工具

WebAssembly提案支持

本仓库实现了所有标准化WebAssembly提案。所有Stage 4+的提案在验证中默认启用：

• 组件模型 (例外，虽非stage4+但默认启用)
• 异常处理
• 多内存
• 尾调用
• 线程等

库

许多CLI工具在仓库中也有对应的Rust库：

• wasmparser - 解析WASM二进制
• wat - 解析WASM文本格式
• wasmprinter - 将WASM二进制转为字符串形式
• wasm-mutate - WASM测试用例变异器
• wit-component - 从核心WASM模块创建组件

建议在嵌入其他项目时直接使用库而非CLI工具。

许可证

三重许可：

• Apache 2许可证
• 带LLVM异常的Apache 2许可证
• MIT许可证