如何编译适配Espressif Wasm Micro Runtime的ESP32 Wasm程序？

核心前提 #

Espressif的Wasm Micro Runtime（WAMR）仅支持标准Wasm核心指令集，默认适配WASI（WebAssembly System Interface）子集，必须生成无JS依赖的纯Wasm模块，避开Emscripten等工具生成的带胶水代码的复杂模块。

推荐方案：使用WAMR自带的wamrc编译器 #

这是适配性最高的方式，步骤如下：

1. 编译wamrc工具

   git clone https://github.com/bytecodealliance/wasm-micro-runtime.git
   cd wasm-micro-runtime/wamr-compiler
   mkdir build && cd build
   cmake .. && make
   

   编译完成后会得到wamrc可执行文件。

2. 将C代码编译为标准Wasm
   先用clang转成LLVM字节码，再链接为Wasm：

   # 假设你的C源文件为test.c
   clang --target=wasm32-wasi -O2 -c test.c -o test.o
   wasm-ld --no-entry --export-all --allow-undefined test.o -o test.wasm
   

   • --no-entry：无需Emscripten式的入口点
   • --export-all：确保所有C函数能被WAMR调用

3. 生成适配WAMR的优化模块

   ./wamrc -o test_optimized.wasm test.wasm
   

   该模块会完全匹配WAMR的指令集要求，无兼容性问题。

备选方案：用Emscripten生成纯Wasm模块 #

若坚持使用Emscripten，必须禁用所有JS相关选项：

emcc test.c -o test.wasm \
  -nostdlib \
  -Wl,--no-entry \
  -Wl,--export-all \
  -Wl,--allow-undefined \
  -target wasm32-wasi \
  -O2

关键参数说明：

• -nostdlib：不引入Emscripten的JS依赖标准库
• --no-entry：不生成默认入口函数
• --export-all：导出所有C函数供WAMR调用

兼容性验证 #

用WAMR的iwasm工具测试生成的模块：

# 编译iwasm工具
cd wasm-micro-runtime/product-mini/platforms/linux
mkdir build && cd build
cmake .. && make
# 运行测试
./iwasm test_optimized.wasm

能正常执行则说明模块适配成功。

常见避坑点 #

• 禁止使用Emscripten默认的emcc test.c -o test.html/-o test.js命令，这类命令会生成带JS胶水的模块，WAMR不支持。
• 避免使用Wasm非核心指令（如SIMD，除非WAMR编译时开启了对应选项）。
• 确保需被WAMR调用的函数已显式导出，或用--export-all强制导出。

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