必须用emcc而非g++/clang++编译c++为webassembly，它默认生成html+js+wasm三件套，.wasm需js胶水加载；导出函数须用extern "c"并加下划线前缀，通过ccall/cwrap调用。
用 Emscripten 编译 C++ 代码生成 .wasm 文件
核心结论：你得用 emcc（Emscripten 的编译器前端）代替 g++ 或 clang++，它会把 C++ 编译成 WebAssembly + JS 胶水代码，不是直接吐出裸 .wasm 就能跑。
最简流程：
emcc hello.cpp -o hello.html这条命令会生成
hello.html、hello.js 和 hello.wasm 三个文件。直接双击 hello.html 会在浏览器中运行（注意：部分浏览器本地打开 file:// 协议会因 CORS 拒绝加载 .wasm，需起本地服务）。
-
emcc默认输出是“JS + WASM”组合，.wasm是模块，.js负责实例化、内存管理、I/O 绑定 - 加
-s STANDALONE_WASM=1可生成纯.wasm（无 JS 胶水），但你得自己写 JS 加载和实例化逻辑，不推荐新手用 -
-O2或-O3开启优化；-g保留调试信息（生成.wasm同时带 DWARF） - 不支持所有 C++ 标准库特性（比如
std::thread、部分std::filesystem），Emscripten 提供的是精简的 libc++ 实现
处理 main() 之外的函数导出（让 JS 能调用 C++ 函数）
默认情况下，emcc 只导出 main()，且仅在页面加载时自动执行。若你想从 JavaScript 主动调用 C++ 函数（例如点击按钮触发计算），必须显式导出。
示例：C++ 中定义一个加法函数：
立即学习“C++免费学习笔记（深入）”；
extern "C" {
int add(int a, int b) {
return a + b;
}
}
编译时加 -s EXPORTED_FUNCTIONS='["_add"]'（注意下划线前缀，C++ 函数名需用 C 链接避免 mangling）和 -s EXPORTED_RUNTIME_METHODS='["ccall", "cwrap"]'（启用 JS 端调用工具）：
emcc math.cpp -o math.js -s EXPORTED_FUNCTIONS='["_add"]' -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]'
- 导出函数名必须带下划线（
_add），否则 JS 找不到符号 -
extern "C"是必须的，否则 C++ name mangling 会让符号名不可预测 -
ccall适合单次调用；cwrap返回一个可复用的 JS 函数包装器 - 若函数参数含指针或字符串，需配合
Module._malloc和Module.UTF8ToString手动管理内存
常见报错与绕过方式
编译失败往往不是语法问题，而是 Emscripten 环境或 API 兼容性导致：
-
undefined symbol: __cxa_throw：说明用了 C++ 异常但没开启异常支持，加-s EXCEPTION_HANDLING=1 -
cannot find -lc或undefined reference to 'printf'：检查是否误用了gcc而非emcc；或忘了链接标准库（emcc默认带，但自定义-nostdlib会禁用） - 浏览器控制台报
WebAssembly.instantiate(): Import #0 module="env" error: module is not an object or function：JS 胶水代码版本与.wasm不匹配，删掉旧生成物，重新emcc全量编译 - 本地双击
.html报 CORS 错误：启动简易服务，如npx http-server或 Pythonpython3 -m http.server 8000
如何加载并运行生成的 WASM（最小 JS 调用模板）
如果你只想要一个空 HTML 页面手动触发 C++ 函数，不用 emcc 自动生成的胶水，可以手写加载逻辑 —— 但前提是用了 -s STANDALONE_WASM=1 并导出了函数。
更实际的做法是依赖 emrun 或直接使用 emcc 输出的 .js：
<script src="hello.js"></script>
<script>
Module.onRuntimeInitialized = () => {
const result = Module.ccall('add', 'number', ['number', 'number'], [2, 3]);
console.log(result); // 5
};
</script>
-
Module.onRuntimeInitialized是关键钩子，确保 WASM 已加载、内存已分配、运行时就绪 -
ccall第二个参数是返回类型（'number'/'string'/null），第三个是参数类型数组，第四个是实际参数值 - 不要在
onRuntimeInitialized外直接调用ccall，否则Module可能未定义或未就绪 - 如果 C++ 函数返回
char*，JS 端要用Module.UTF8ToString(ptr)转换，且确保该内存生命周期可控（别在 C++ 中free后还读）
