Wit on 楠楠自瑜

如何基于 .wit 文件生成 rust 代码

Wed, 15 Apr 2026 14:42:40 +0800

IronClaw 采用 wasm 沙箱隔离作为其安全机制，IronClaw 宿主和沙箱之间的交互接口是在 .wit 文件中定义的，例如 channel.wit of IronClaw。

这篇文章回答一个问题：如何基于定义好的 wit 文件生成 rust 代码？

wit-bindgen 是 Bytecode Alliance 开发的官方工具，它能将 .wit 文件中定义的接口转换为 Rust 代码。它主要有两种使用方式：

在 build.rs 构建脚本中使用命令行工具
或在代码中使用 wit-bindgen 库的宏

方法一：在 `build.rs` 中使用 CLI 工具（`wit-bindgen-cli`）

这种方式在构建时生成一次绑定文件（例如 bindings.rs），之后可以作为常规 Rust 模块引入。

1. 添加依赖

在 Cargo.toml 中，将 wit-bindgen-cli 添加到 build-dependencies，并把生成的 bindings.rs 包含在 lib.rs 中：

# Cargo.toml
[package]
# ...
build = "build.rs"

[lib]
# 声明生成的 bindings 模块
path = "src/lib.rs"

[build-dependencies]
wit-bindgen-cli = "0.28.0"

// src/lib.rs
// 声明由 build.rs 生成的 bindings 模块
mod bindings;
pub use bindings::*;

2. 编写构建脚本 (`build.rs`)

在项目根目录下创建 build.rs，使用 wit_bindgen_cli::generate! 宏处理 .wit 文件。