不能直接用 <script type="module"> 引入 .wasm 文件，因浏览器不识别二进制模块，会报 MIME 类型错误；首选 fetch() + WebAssembly.instantiateStreaming() 实现流式编译，但需服务端返回 Content-Type: application/wasm 且配置 CORS。
不能用 <script type="module"> 直接引入 .wasm 文件——浏览器根本不识别二进制模块，会直接报 MIME 类型错误或空响应。
为什么 fetch() + WebAssembly.instantiateStreaming() 是首选
它支持流式编译：字节流一到达就解析，不用等整个文件下载完，首屏启动快。但有两个硬性前提：
- 服务器必须返回
Content-Type: application/wasm（不是application/octet-stream） - 请求需带
mode: 'cors'（跨域时）且服务端配好Access-Control-Allow-Origin - 如果服务端不支持 streaming（比如老旧 Nginx 未配 MIME 类型），会 fallback 到
fetch().then(r => r.arrayBuffer())+WebAssembly.compile()，性能下降明显
示例关键片段：
fetch('calc.wasm', { mode: 'cors' })
.then(response => WebAssembly.instantiateStreaming(response))
.then(({ instance }) => console.log(instance.exports.add(2, 3)));
WebAssembly.instantiate() 和 instantiateStreaming() 参数差异
前者接收已加载完成的 ArrayBuffer 或 TypedArray，后者直接接收 Response 对象（必须是流式可读的）。
立即学习“前端免费学习笔记（深入）”；
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
instantiate()更可控：适合解密后、动态拼接、或兼容老环境；但内存占用高（要先完整加载） -
instantiateStreaming()更高效：但要求服务端配合，且无法在解密场景中直接使用（加密 wasm 无法流式解密） - 两者都接受第二个参数
importObject，用于注入 JS 函数（如env.abort、js.print）
CORS 和 CSP 常见报错及修复点
典型错误包括：TypeError: Failed to execute 'fetch' on 'Window': Request mode is 'cors' but response's redirect mode is 'follow'，或控制台提示 Blocked by Content-Security-Policy。
- Nginx 配置必须显式声明
types { application/wasm wasm; }并加add_header 'Access-Control-Allow-Origin' 'https://your.app'; - HTML 中需加 CSP 元标签：
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'wasm-unsafe-eval'">（Chrome/Firefox 当前强制要求wasm-unsafe-eval） - 若用
credentials: 'include'，服务端Access-Control-Allow-Origin不能为*，必须精确匹配 Origin
加密 wasm 加载时最容易漏掉的校验环节
前端解密后得到的 Uint8Array 必须严格还原原始 wasm 格式——开头 4 字节魔数 00 61 73 6D（即 \0asm）缺一不可，否则 WebAssembly.compile() 会静默失败或抛 CompileError: invalid magic number。
建议解密后立即做两件事：
- 检查
bytes[0] === 0 && bytes[1] === 0x61 && bytes[2] === 0x73 && bytes[3] === 0x6D - 用
WebAssembly.validate(bytes)同步校验（不执行，只验格式），避免传给instantiate()后才暴露问题
实际项目里，这个校验常被跳过，导致开发时正常、上线后白屏且无明确报错。
