# WebAssembly与边缘计算
示例： 在Wasm中分配一个整数数组并求和。
关键代码（WAT格式，Wasm文本格式）：
(module
(memory (export "mem") 1) ;; 1页内存（64KB）
(func (export "sum_array") (param $offset i32) (param $len i32) (result i32)
(local $i i32)
(local $sum i32)
(loop $loop
(if (i32.lt_s (local.get $i) (local.get $len))
(then
(local.set $sum (i32.add (local.get $sum) (i32.load (i32.add (local.get $offset) (i32.mul (local.get $i) (i32.const 4))))))
(local.set $i (i32.add (local.get $i) (i32.const 1)))
(br $loop)
)
)
)
(local.get $sum)
)
)
说明： 此模块导出一个线性内存mem和一个函数sum_array，从偏移量$offset开始读取$len个32位整数并求和。运行前，宿主机需将数组写入该内存。
2. Rust编译到WebAssembly：工具链与优化
Rust通过wasm32-unknown-unknown目标编译为Wasm，无需外部运行时。使用wasm-pack工具可自动生成绑定代码，支持在Node.js或浏览器中调用。优化选项包括-O3（大小优化）或-Oz（激进大小优化）。
示例： 用Rust编写一个斐波那契函数并编译为Wasm。
关键代码（Rust）：
// fib.rs
#[no_mangle]
pub extern "C" fn fib(n: u32) -> u32 {
if n <= 1 {
return n;
}
let mut a = 0;
let mut b = 1;
for _ in 2..=n {
let temp = a + b;
a = b;
b = temp;
}
b
}
编译命令：
rustup target add wasm32-unknown-unknown
rustc --target wasm32-unknown-unknown -O3 fib.rs -o fib.wasm
说明： #[no_mangle]防止函数名被混淆，extern "C"确保使用C ABI兼容的调用约定。编译后得到fib.wasm，可直接在Wasmtime中执行。
3. Wasmtime运行时：嵌入与调用
Wasmtime是轻量级、高性能的Wasm运行时，支持Rust、C、Python等语言嵌入。它提供安全的沙箱环境，通过Instance对象调用Wasm函数。
示例： 用Rust语言通过Wasmtime调用fib.wasm。
关键代码（Rust）：
use wasmtime::{Engine, Module, Store, Linker, TypedFunc};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let engine = Engine::default();
let module = Module::from_file(&engine, "fib.wasm")?;
let linker = Linker::new(&engine);
let mut store = Store::new(&engine, ());
let instance = linker.instantiate(&mut store, &module)?;
let fib: TypedFunc<u32, u32> = instance.get_typed_func(&mut store, "fib")?;
let result = fib.call(&mut store, 10)?;
println!("fib(10) = {}", result); // 输出55
Ok(())
}
说明： 需在Cargo.toml中添加wasmtime = "14.0"依赖。Wasmtime负责加载模块、解析导入、管理内存，并执行函数。
4. 边缘计算场景：数据预处理与过滤
边缘设备通常处理传感器数据流，Wasm模块可高效执行过滤、归一化等操作，降低传输到云端的带宽需求。
示例： 从温度传感器读取数据，过滤出异常值（>50°C）。
关键代码（Rust）：
// filter.rs
#[no_mangle]
pub extern "C" fn filter_temperatures(input: *const f32, len: u32, output: *mut f32, max_len: u32) -> u32 {
let input_slice = unsafe { std::slice::from_raw_parts(input, len as usize) };
let output_slice = unsafe { std::slice::from_raw_parts_mut(output, max_len as usize) };
let mut count = 0;
for &val in input_slice {
if val > 50.0 {
if count >= max_len as usize {
break;
}
output_slice[count] = val;
count += 1;
}
}
count as u32
}
说明： 此函数接收指向输入数组、输出数组的指针，以及长度信息。边缘设备上的主程序（如C或Rust）需分配内存并调用此Wasm函数。
二、实操步骤
步骤1：搭建开发环境
1. 安装Rust：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. 添加Wasm目标：rustup target add wasm32-unknown-unknown
3. 安装Wasmtime CLI：curl https://wasmtime.dev/install.sh -sSf | bash
4. 验证：wasmtime --version 应输出版本号。
步骤2：编写并编译Wasm模块
1. 创建项目目录：mkdir edge_filter && cd edge_filter
2. 编写Rust代码，保存为src/lib.rs，内容为上述filter_temperatures函数的完整代码。
3. 创建Cargo.toml：
[package]
name = "edge_filter"
version = "0.1.0"
edition = "2021"
[lib]
crate-type = ["cdylib"]
4. 编译：cargo build --release --target wasm32-unknown-unknown
5. 输出文件位于target/wasm32-unknown-unknown/release/edge_filter.wasm
步骤3：使用Wasmtime CLI测试
1. 创建一个WAT文件test.wat来模拟调用：
(module
(import "env" "filter_temperatures" (func $filter (param i32 i32 i32 i32) (result i32)))
(memory (export "mem") 1)
(data (i32.const 0) "\x00\x00\x48\x42\x00\x00\x48\x42\x00\x00\xC8\x42\x00\x00\x48\x42") ;; 浮点数：50.0, 50.0, 100.0, 50.0
(func (export "run") (result i32)
i32.const 0 ;; input pointer
i32.const 4 ;; len
i32.const 16 ;; output pointer
i32.const 4 ;; max_len
call $filter
)
)
2. 运行：wasmtime run --dir . test.wat（注意：实际测试需借助宿主程序，此处仅为示意）
步骤4：集成到边缘设备（模拟）
1. 编写一个简单的Rust宿主程序host.rs：
use wasmtime::{Engine, Module, Store, Linker, Memory, TypedFunc};
use std::mem;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let engine = Engine::default();
let module = Module::from_file(&engine, "target/wasm32-unknown-unknown/release/edge_filter.wasm")?;
let linker = Linker::new(&engine);
let mut store = Store::new(&engine, ());
let instance = linker.instantiate(&mut store, &module)?;
let memory: Memory = instance.get_memory(&mut store, "mem").unwrap();
// 写入数据
let input_data: [f32; 4] = [50.0, 51.0, 100.0, 49.0];
let input_ptr = 0;
memory.write(&mut store, input_ptr, unsafe { mem::transmute::<&[u8], &[u8]>(&input_data) })?;
// 调用函数
let filter: TypedFunc<(i32, i32, i32, i32), i32> = instance.get_typed_func(&mut store, "filter_temperatures")?;
let output_ptr = 16;
let count = filter.call(&mut store, (input_ptr, 4, output_ptr, 4))?;
// 读取输出
let mut output_buf = vec![0u8; (count as usize) * 4];
memory.read(&mut store, output_ptr, &mut output_buf)?;
let output: Vec<f32> = output_buf.chunks_exact(4).map(|c| f32::from_ne_bytes(c.try_into().unwrap())).collect();
println!("Filtered values: {:?}", output); // 输出 [51.0, 100.0]
Ok(())
}
2. 运行宿主程序：cargo run
步骤5：验证结果
观察输出，应仅包含大于50.0的值（51.0和100.0）。若结果正确，则说明Wasm模块在边缘环境中正常工作。
三、常见问题与故障排查
问题1：编译时出现“target not found”错误
原因： 未添加wasm32-unknown-unknown目标。
解决： 运行rustup target add wasm32-unknown-unknown，然后重新编译。
问题2：Wasm模块中函数返回错误值或崩溃
原因： 内存指针或长度参数传递错误。
解决： 检查宿主程序传入的指针是否在Wasm模块的线性内存范围内（通常从0开始），并确保长度与实际数据大小匹配。
问题3：Wasmtime运行时报错“uninitialized memory”
原因： 访问未初始化的内存区域。
解决： 在Wasm模块中，若需要写入数据，先分配内存（如通过memory.grow）或确保宿主程序已写入有效数据。
问题4：Rust编译后Wasm文件过大
原因： 默认未启用大小优化或包含调试信息。
解决： 在Cargo.toml中设置[profile.release] opt-level = "z" lto = true，并使用wasm-opt工具进一步压缩。
问题5：边缘设备上内存不足
原因： Wasm模块初始内存页数过多（默认1页=64KB）。
解决： 在Rust中通过#[link_section = "custom"]自定义内存初始大小，或使用wasmtime的Config限制内存上限。
四、总结与扩展学习
本课程介绍了WebAssembly的核心原理（线性内存与沙箱）、Rust编译到Wasm的方法、Wasmtime运行时的使用，以及边缘计算中的数据过滤实践。关键点包括：Wasm的零成本抽象、Rust的extern "C"导出、Wasmtime的嵌入API、以及边缘设备上的内存管理。
扩展学习方向：
- 探究Wasm的**多线程**支持（SharedArrayBuffer）和**GC**提案（如Wasm-GC）。
- 学习**WASI**（WebAssembly System Interface）以访问文件系统、网络等系统资源。
- 使用**wasm-bindgen**或**wasm-pack**与JavaScript前端集成。
- 研究边缘计算框架如**Cloudflare Workers**或**Fastly Compute@Edge**，它们原生支持Wasm部署。
- 尝试用Wasm实现一个简单的边缘AI推理模型（如ONNX Runtime + Wasm）。