ffmpeg.wasm等模块需用emscripten将c/c++源码重新编译为wasm字节码并补全js胶水层，因浏览器沙箱禁止执行原生机器码且无posix接口，须重写或模拟libavdevice、simd调用、动态内存分配等功能。
ffmpeg.wasm 和 wasm-av1 这类模块不是“搬运”而是“重新编译”——你没法直接把原生二进制 FFmpeg 丢进浏览器跑，必须用 Emscripten 把 C/C++ 源码交叉编译成 WebAssembly 字节码，并补全 JS 胶水层。真正的瓶颈不在加载速度，而在内存模型适配和 I/O 模拟。
为什么不能直接运行原生 FFmpeg 二进制
浏览器沙箱禁止直接执行机器码，也不提供 POSIX 系统调用接口（如 open()、fork()）。FFmpeg 原生依赖大量系统级功能：libavdevice 读摄像头、libswscale 调用 SIMD 指令、libavcodec 动态分配大块内存——这些在 WASM 中必须重写或模拟。
常见错误现象：RuntimeError: abort(abortOnCannotGrowMemory) 或控制台报 FS.writeFile is not a function，本质都是胶水层没桥接好底层调用。
- WebAssembly 内存是线性、固定页（64KB/页）的
ArrayBuffer，无法像原生 malloc 那样随意伸缩；必须显式启用-s ALLOW_MEMORY_GROWTH=1 - FFmpeg 的文件 I/O 被重定向到 Emscripten 的虚拟文件系统（
FS），ffmpeg.FS('writeFile', ...)才是正确写法，不是fs.writeFileSync - 音视频解码器启用需手动开启对应编解码器开关，例如 AV1 解码必须在 configure 阶段加
--enable-libaom，否则ffmpeg -decoders列表里压根不显示libaom_av1
ffmpeg.wasm 加载慢且首次使用卡顿的根源
不是网络问题，是初始化阶段要完成三件事：下载 8–15MB 的 ffmpeg-core.wasm、解析并实例化模块、预分配约 256MB 虚拟内存空间（即使只转几秒视频）。这个过程不可跳过，但可异步隐藏。
典型误操作：在用户点击“开始转换”后才调用 ffmpeg.load()，导致 UI 卡死 3–8 秒。
- 必须在页面加载完成时就提前调用
await ffmpeg.load()，哪怕用户还没上传文件 - 若需支持多实例（如同时处理多个视频），不要重复
createFFmpeg()，复用同一实例更省内存 - 对 1080p 视频，建议预分配内存不少于
-s INITIAL_MEMORY=536870912（512MB），否则运行中扩容会触发 GC 暂停
AV1 / HEVC 软解必须绕开的兼容性坑
wasm-av1 和 B站 WasmPlayer 的 HEVC 解码器，都依赖浏览器对 WebAssembly SIMD 和 BigInt 的支持。Chrome 91+、Firefox 93+ 才稳定启用 simd128 指令集，旧版本会自动退化为纯标量解码，性能跌 60% 以上。
错误判断方式：“能跑 demo 就代表支持”——其实只是 JS 层没报错，但解码帧率可能只有 2fps。
- 检测真实能力要用
WebAssembly.validate(bytes, { simd: true })，而非仅检查typeof WebAssembly.Simd - HEVC 解码必须开启
-s STACK_SIZE=5242880（5MB 栈空间），否则复杂 GOP 结构下极易栈溢出 - AV1 解码器输出 YUV420P 后，浏览器不支持直接渲染，得用
OffscreenCanvas+ctx.putImageData()手动转 RGB，这步 CPU 开销常被低估
本地文件处理时的真实 I/O 瓶颈
用户拖入一个 500MB 的 MKV 文件，fetchFile(inputBlob) 不是流式读取，而是把整个 Blob 转成 Uint8Array 加载进内存——这意味着浏览器瞬间吃掉 500MB+ 内存，容易触发 OOM kill。
解决方案不是“优化代码”，而是改交互逻辑：
- 对 >100MB 文件，强制分片读取：
inputBlob.slice(0, 10485760)（10MB）逐块写入FS，再调用ffmpeg.run('-ss', '00:00:10', '-i', 'input.mkv', ...)跳帧处理 - 避免用
URL.createObjectURL()创建临时地址再 fetch，WASM 模块无法访问该 URL，必须走fetchFile()或FS.writeFile() - 处理完务必调用
ffmpeg.FS('unlink', 'input.mkv')清理虚拟文件系统，否则后续同名文件写入会失败
