要生成可直接加载的纯.wasm文件，必须使用emcc hello.cpp -o hello.wasm -s STANDALONE_WASM=1；若含C++标准库则不可用该选项，否则链接失败。
emscripten 编译命令怎么写才不报错
直接用 emcc 替代 g++，但默认输出是 JavaScript 胶水代码 + wasm 二进制，不是纯 wasm。想生成可直接加载的 .wasm 文件，必须加 -s STANDALONE_WASM=1，否则会依赖 JS runtime（比如内存初始化、堆管理），浏览器里 WebAssembly.instantiate() 直接失败。
常见错误现象：RuntimeError: abort(CompileError: WebAssembly.instantiate(): expected magic word 00 61 73 6d, found 3c 21 44 4f...)——说明你拿到的是 HTML 或 JS 文件，不是 wasm。
-
emcc hello.cpp -o hello.wasm -s STANDALONE_WASM=1→ 输出纯 wasm（无 JS） -
emcc hello.cpp -o hello.js→ 默认行为，生成 JS +hello.wasm，JS 负责加载和 glue - 如果用了 C++ 标准库（如
std::string、std::vector），必须保留 JS 胶水层，STANDALONE_WASM=1会报链接错误
如何让 C++ 函数被 JS 正确调用
Wasm 模块本身没有导出符号表，C++ 函数名会被 name mangling 破坏，JS 拿不到。必须显式用 extern "C" 声明，并用 EMSCRIPTEN_KEEPALIVE 防止被 LTO 优化掉。
使用场景：你想在网页里调用 add(int, int)，而不是靠胶水 JS 的 _malloc 或 _free 这类底层符号。
立即学习“C++免费学习笔记（深入）”；
- 头文件或实现前加：
extern "C" { __attribute__((used)) int add(int a, int b); } - 函数定义前加：
EMSCRIPTEN_KEEPALIVE（需包含<emscripten.h>） - 编译时加
-s EXPORTED_FUNCTIONS='["_add"]'，注意下划线前缀和引号格式 - 不加
EXPORTED_FUNCTIONS，即使加了EMSCRIPTEN_KEEPALIVE，函数也可能不出现在 wasm 的 export section 中
为什么 malloc 返回的指针在 JS 里不能直接当数组用
Wasm 线性内存是一整块 ArrayBuffer，C++ 的 malloc 分配的是这个 buffer 内部偏移，不是 JS 可访问的地址。JS 拿到的只是一个数字（比如 1024），它其实是字节偏移量，不是指针。
性能影响：每次读写都要通过 Module.HEAP32、Module.HEAP8 等视图转换，不能直接传给 new Uint8Array() 构造器——除非你手动做 new Uint8Array(Module.buffer, ptr, len)。
- 从 C++ 传字符串给 JS：用
emscripten::val::module_property("HEAP8")+ptr+len构造视图，再用TextDecoder解码 - JS 传数据给 C++：先
malloc足够空间，再用HEAP8.set()写入，最后把ptr传给 C++ 函数 - 别用
Module._malloc返回值直接做new Int32Array(ptr)——这会越界，因为 ptr 是 offset，不是 ArrayBuffer 地址
emscripten 版本和 target 选错会导致什么
新版 Emscripten（2.0.30+）默认生成 wasm64 不兼容旧浏览器；而老版本（1.39.x）不支持 STANDALONE_WASM=1。更隐蔽的问题是：用 emrun 启动本地服务时，若没加 --no-serve-wasm，它可能把 wasm 当作普通静态资源返回 text/plain MIME 类型，Chrome 直接拒载。
- 生产环境务必用
emrun --no-serve-wasm .或 Nginx 配置application/wasmMIME 类型 - 目标平台写成
-s TARGET_ENVIRONMENT='web'，否则在 Node.js 环境下生成的模块可能用fs调用，浏览器跑不了 - 调试阶段加
-g和-s DEMANGLE_SUPPORT=1，否则 stack trace 里全是_Z3fooi这种符号，没法定位
最常被忽略的是内存初始化方式：INITIAL_MEMORY 和 MAXIMUM_MEMORY 不设的话，Emscripten 会按需增长内存，但某些浏览器对 grow_memory 指令有策略限制，导致运行时报 RuntimeError: memory access out of bounds——这时候得固定内存大小并预分配。
