最小可行流程是：安装Emscripten后执行emcc hello.cpp -o hello.html，生成hello.html、hello.js、hello.wasm三文件；须用本地服务器（如npx http-server）运行，不可双击打开。
用 Emscripten 编译 C++ 到 WASM 的最小可行流程
直接编译能跑就行，不需要额外框架。Emscripten 是目前最稳定、兼容性最好的工具链，它把 C++ 代码转成 .wasm 文件 + 一个 JS 胶水脚本（xxx.js），两者缺一不可。
安装后执行：
emcc hello.cpp -o hello.html就会生成
hello.html、hello.js、hello.wasm 三个文件。直接双击打开 hello.html 会失败——因为浏览器禁止本地加载 .wasm，必须起一个本地服务，比如：npx http-server
-
emcc默认启用-O2优化，调试时加-g和--profiling才能保留符号和调用栈 - 不加
-o xxx.html而用-o xxx.js，只会生成 JS + WASM，不带 HTML 容器，适合集成进现有页面 - 如果只想要纯 WASM（无 JS 胶水），得加
--standalone-wasm，但此时无法调用console.log或 DOM，连printf都要自己实现底层输出
从 JavaScript 主动调用 C++ 函数的典型写法
默认生成的胶水 JS 会把 C++ 全局函数暴露在 Module.cwrap 或 Module.ccall 下，前提是函数用 extern "C" 声明并避免 C++ 名字修饰。
例如 C++ 中写：
extern "C" {
int add(int a, int b) { return a + b; }
} 然后编译：emcc math.cpp -o math.js -s EXPORTED_FUNCTIONS='["_add"]' -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]'
-
EXPORTED_FUNCTIONS必须带下划线前缀（_add），这是 Emscripten 的符号命名规则 -
EXPORTED_RUNTIME_METHODS不加的话，Module.ccall会是undefined - JS 里调用：
const add = Module.cwrap('add', 'number', ['number', 'number']); console.log(add(3, 5)); // → 8 - 如果函数参数含指针（比如
char*），要用Module.allocate或Module.stringToUTF8手动管理内存，别直接传 JS 字符串
常见报错：wasm validation error / RuntimeError: abort
这类错误基本都源于内存模型不匹配或导出配置遗漏，不是语法问题。
立即学习“C++免费学习笔记（深入）”；
-
LinkError: WebAssembly.instantiate(): Import #0 module="env" error: module is not an object→ 没用 Emscripten 生成的 JS 加载，而是手动WebAssembly.instantiateStreaming加了原始 WASM 文件；原始 WASM 依赖env模块，必须走胶水 JS 初始化 -
RuntimeError: abort(Assertion failed: undefined)→ 多半是 C++ 里用了未初始化的全局变量，或std::string构造在main外触发（Emscripten 的 global ctors 支持有限） -
Uncaught (in promise) TypeError: Failed to execute 'compile' on 'WebAssembly': Incorrect response MIME type→ 本地服务器没配对.wasm的application/wasm类型，http-server默认支持，Python 的python -m http.server不支持，得换
绕过胶水 JS：用 WebAssembly.instantiateStreaming 手动加载（适合高级控制）
想自己管理内存、自定义导入对象、或对接 Rust/Go 生成的 WASM 时，就得跳过 Emscripten 胶水，直连底层 API。但 Emscripten 默认生成的 WASM 是“动态链接”模式，不能直接用。
- 必须加编译参数：
-s STANDALONE_WASM=1 -s EXPORTED_FUNCTIONS='["_add"]' -s EXPORT_NAME='MyModule'
，这样生成的是可独立加载的 WASM - WASM 导出的函数名仍带下划线，JS 中要写
instance.exports._add(3, 5) - 没有
malloc和free，所有内存操作得靠WebAssembly.Memory实例 +Uint8Array手动读写，std::vector这类容器基本不可用 - 若需字符串交互，得约定内存布局：比如 C++ 把字符串写入线性内存某段，JS 用
TextDecoder解码；反过来 JS 写入，C++ 用strlen判断长度
真正麻烦的从来不是编译命令，而是 C++ 和 JS 之间那层薄薄的 ABI 边界——类型怎么对齐、内存谁来管、错误怎么传、生命周期怎么同步。Emscripten 胶水帮你挡掉了 80% 的坑，但一旦想绕开它，每个字节都得亲手校验。
