WebAssembly/Emscripten本地构建报错求助（macOS环境）

1. main未定义错误 #

Emscripten默认要求C/C++代码必须有main函数作为程序入口。如果你的module.cpp是一个没有入口的库模块，直接编译会触发这个错误。解决方法：添加编译参数-s NO_MAIN=1，告诉Emscripten不需要寻找main函数。

2. _emval_系列未定义符号错误 #

_emval_开头的符号是Emscripten用于JS与C++对象交互的emval模块相关实现。出现这个错误有两种可能：

• 你的代码里用到了emval.h的API，但编译时没启用该模块支持，添加-s USE_EMVAL=1参数即可启用。
• 你没用到emval功能，但代码里不小心包含了emval.h或者调用了相关函数，检查代码去掉不必要的引用就行。

3. 返回栈内存警告 #

这个警告是因为Emscripten检测到你的代码可能把栈上分配的内存返回给JS。栈内存会在函数执行完毕后被回收，JS后续访问这块内存会触发错误。解决思路：

• 把需要返回的内存分配到堆上（比如用malloc或new），同时用EMSCRIPTEN_KEEPALIVE标记相关函数，避免内存被提前释放。
• 确认代码逻辑，不要返回栈上的局部变量指针。如果是误报，可以用-s WARN_ON_UNDEFINED_SYMBOLS=0关闭警告，但优先排查代码更稳妥。

参考编译命令 #

如果是无main的库模块且用到emval：

emcc module.cpp -o module.wasm -s WASM=1 -s NO_MAIN=1 -s USE_EMVAL=1

如果没用到emval：

emcc module.cpp -o module.wasm -s WASM=1 -s NO_MAIN=1

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