C++无法直接调用Wasm函数，必须通过Emscripten生成的JS胶水层中转；需用EMSCRIPTEN_KEEPALIVE标记导出函数，限定为C ABI和基础类型，并配合EXPORTED_FUNCTIONS指定导出名。
如何从C++代码里调用已编译的Wasm函数？
Emscripten生成的Wasm模块默认不暴露C++符号给宿主JS，反过来，C++主程序也不能直接“链接”外部Wasm二进制——它根本不是传统意义上的动态库。真正可行的路径是：让Wasm模块导出函数，再通过Emscripten自动生成的JS胶水代码（Module）把它们桥接到C++侧。
- 必须用
EMSCRIPTEN_KEEPALIVE宏标记要导出的C++函数，否则会被Link Time Optimization（LTO）干掉 - 导出函数只能使用C ABI（即
extern "C"），不能带重载、模板或std::string等非POD类型 - 所有参数和返回值需是基础类型（
int、float、const char*等），字符串需手动管理内存生命周期
例如，在Wasm模块中写：
#include <emscripten.h>
extern "C" {
EMSCRIPTEN_KEEPALIVE
int add(int a, int b) { return a + b; }
}
编译时加-s EXPORTED_FUNCTIONS='["_add"]'，才能确保_add出现在Module._add上。
为什么C++主程序不能直接dlopen或LoadLibrary加载.wasm文件？
Wasm不是ELF或PE格式，操作系统加载器根本不认识它。浏览器和Node.js里的Wasm运行时（如V8、SpiderMonkey）是独立实现的执行环境，和本地进程的地址空间、调用约定、异常机制完全隔离。
-
.wasm文件本质是字节码，必须由Wasm虚拟机实例化后才能执行，无法像.so那样被dlopen映射进当前进程 - 即使你用
std::ifstream读取了.wasm二进制，也没法靠C++原生代码“调用”它——缺少执行上下文、内存视图、导入表绑定等基础设施 - Emscripten的
EM_ASM或EM_ASM_INT可以嵌入JS逻辑，但那是把控制权交还给JS运行时，不是C++直调Wasm
换句话说：C++调Wasm ≠ C++调DLL；它是“C++ → JS胶水层 → Wasm实例”，中间那层JS绕不开。
立即学习“C++免费学习笔记（深入）”；
EM_ASM和EM_JS哪个更适合触发Wasm导出函数？
EM_JS用于声明JS函数供C++调用，适合封装复杂逻辑；EM_ASM是内联JS片段，适合简单、一次性的调用。
- 如果只是传两个整数、拿一个返回值，用
EM_ASM_INT({ return Module._add($0, $1); }, a, b)最轻量 - 如果要多次调用、处理指针（比如传入
uint8_t*数组）、或需要错误检查，应先用EM_JS定义一个JS wrapper，再在C++里调它 - 注意
$0、$1是EM_ASM里的占位符，对应后续参数，类型自动转为JS可接受形式（int变number，char*变JS string，但会拷贝） - 指针操作危险：
EM_ASM里拿到的char*是Wasm线性内存地址，JS侧不能直接解引用，必须配合HEAP8等视图访问
比如传数组：
EM_ASM({
const ptr = $0;
const len = $1;
for (let i = 0; i < len; ++i) {
console.log(HEAP8[ptr + i]);
}
}, arr_ptr, arr_len);
常见报错Module._xxx is not a function怎么定位？
这个错误90%是因为导出没生效，而不是JS加载失败。
- 检查编译命令是否含
-s EXPORTED_FUNCTIONS='["_xxx"]'，且函数名带下划线（C++函数add导出后是_add） - 确认
EMSCRIPTEN_KEEPALIVE已包含在函数定义中，且头文件<emscripten.h></emscripten.h>已引入 - 在浏览器Console里打印
Object.keys(Module)，看_xxx是否在列表里；如果不在，说明链接阶段已被strip - 如果用了
-O2或更高优化级，务必加--no-file-system --no-entry等精简选项，避免Emscripten自动裁剪未引用符号
最容易被忽略的是：C++源码改了，但忘了重新emcc编译生成新的.js和.wasm——旧JS胶水代码根本不知道新函数存在。
