WebAssembly模块不能用<script src="xxx.wasm">加载，必须通过JavaScript API（如WebAssembly.instantiateStreaming()）调用；90%加载失败源于MIME类型错误、CORS限制或导出名不匹配，而非代码缺陷。
直接结论：WebAssembly 模块不能靠 <script src="xxx.wasm"> 加载，必须走 JavaScript API 流程；加载失败 90% 是 MIME 类型、CORS 或导出名不匹配导致的，不是代码写错了。
为什么 <script> 标签加载 .wasm 文件会静默失败
浏览器根本不识别二进制 .wasm 文件为可执行模块。当你写 <script src="logic.wasm">，浏览器会尝试按 JS 解析，但遇到非法 UTF-8 字节流就放弃，控制台通常只显示空错误或 MIME 类型警告，不会抛出明确异常。
- 服务端返回的
Content-Type必须是application/wasm（不是application/octet-stream或缺失） - 开发时用
npx serve或 VS Code Live Server 即可自动设对 MIME；生产环境 Nginx 需显式配置types { application/wasm wasm; } - 若用 Webpack 打包，
type: 'webassembly/async'必须在module.rules中声明，否则import语句会被忽略
WebAssembly.instantiateStreaming() 和 WebAssembly.instantiate() 怎么选
instantiateStreaming() 更快，但依赖服务端支持；instantiate() 更可控，适合解密、拼接或兼容老环境。
-
instantiateStreaming()接收Response对象，边下载边编译，首字节延迟低；但要求响应头含Content-Type: application/wasm且不能重定向（否则报Request mode is 'cors' but response's redirect mode is 'follow'） -
instantiate()接收已加载完的ArrayBuffer，适合做缓存、校验（WebAssembly.validate(bytes)）、或从加密 blob 构造字节码 - 两者第二参数都是
importObject，必须严格匹配 Wasm 模块期望的导入项名称和类型，比如 C 编译的模块常要{ env: { abort: () => {} } }
导出函数调用前必须确认的三件事
即使 instance 创建成功，instance.exports.add(1,2) 仍可能报 TypeError: instance.exports.add is not a function——这不是 JS 错误，而是 Wasm 导出契约没对齐。
立即学习“前端免费学习笔记（深入）”；
- C/C++ 函数默认导出名带下划线前缀，如
int add(int a, int b)编译后是_add，除非加EMSCRIPTEN_KEEPALIVE或-s EXPORT_NAME=add - 导出函数签名必须是纯数值（
i32,f64等），JS 传字符串、对象、数组会直接崩溃；需先写入instance.exports.memory，再把内存地址当参数传 - 首次调用前建议检查
instance.exports是否包含预期键名：console.log(Object.keys(instance.exports))，避免拼写错误或链接遗漏
Worker 中复用 Wasm 实例的关键细节
Worker 不是“把 Wasm 搬过去就完事”，主线程卡顿问题不会自动消失——如果每次计算都重新 fetch + compile，反而更慢。
- Worker 内应将
WebAssembly.Module缓存为全局变量，后续WebAssembly.instantiate(module, importObject)复用，避免重复编译开销 - 若模块启用线程（
-s THREADS=1），必须提前创建SharedArrayBuffer并注入importObject的global域，否则运行时报Atomics is not defined - 主线程向 Worker 传大数组时，务必用
postMessage(data, [array.buffer])移交所有权；Worker 收到后直接用同一ArrayBuffer构建Uint8Array，别 clone 或 copy
最易被忽略的是：Wasm 模块的 memory 默认可增长，但增长操作本身是同步的，且可能触发 GC；高频小内存分配（比如每帧写字符串）会成为隐性瓶颈，应预分配足够空间并复用偏移地址。
