要在火狐浏览器里跑起WebAssembly多线程，需要服务器响应头、HTTPS安全上下文和浏览器内部开关三者同时到位，缺一不可。

直接拿file://协议打开.wasm文件？必然失败。必须通过HTTP或HTTPS服务来访问。下面把整套配置流程拆开讲清楚。

确认基础WASM功能已启用

Firefox 120+ 默认支持基础WebAssembly，但线程支持的那个底层开关还需要手动打开。具体操作如下：

• 地址栏输入about:config，回车，点击“接受风险并继续”。
• 搜索ja vascript.options.wasm，确认值为true；如果是false，双击改为true。
• 再搜索ja vascript.options.sharedarraybuffer——这个必须设为true，否则SharedArrayBuffer被禁用，多线程根本无法初始化。这一步很多人容易漏掉。

配置服务端响应头（关键步骤）

光改浏览器设置远远不够。页面必须运行在具备跨域隔离能力的上下文中。简单说，服务器需要返回两个特殊的响应头。有两种常用方法：

方法一：用支持自定义头的本地开发服务器

启动Python 3内置HTTP服务器时，光靠python3 -m http.server 8000 --bind 127.0.0.1是不够的。需要搭配nginx或Node.js中间件来注入头信息。最终响应里必须强制写入这两行：

Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp

方法二：用Vite或Webpack Dev Server（推荐）

在vite.config.js里添加server.headers配置项，直接注入上面两个头即可。如果不配置，浏览器会静默禁用SharedArrayBuffer。控制台看不到明显报错，但new SharedArrayBuffer()会抛出TypeError。这个坑踩过的人不少。

验证线程能力是否就绪

配置完成后，先打开开发者工具（Ctrl+Shift+I），切换到控制台，逐一测试：

1. 输入typeof SharedArrayBuffer。如果返回"function"，说明基础共享内存可用。
2. 输入WebAssembly.validate(new Uint8Array([0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]))。如果返回true，则WASM解析器正常。
3. 创建测试模块时，在WebAssembly.instantiateStreaming的importObject里传入一个带shared:true的Memory：
   {'env': {'memory': new WebAssembly.Memory({initial:1,maximum:1,shared:true})}}
   如果shared:true被忽略或直接报错，说明COOP/COEP头没有生效，或者Firefox版本低于120。

《夸克》非常好用的免费AI浏览器

下载APP查看