WASM SIMD 128 在 C++ 中需显式启用：Emscripten 必须加 -msimd128，头文件 <wasm_simd128.h> 提供底层操作，类型为 v128_t，需匹配浏览器/Node.js 版本并手动处理 fallback。
WASM SIMD 128 在 C++ 中不是开箱即用的
Clang/LLVM 支持 wasm_simd128，但默认不启用；GCC（截至 14.x）完全不支持。如果你用 Emscripten 编译 C++，必须显式开启目标特性，否则所有 v128_t 类型、simd_shuffle 等调用都会编译失败或静默降级为标量代码。
- 检查是否启用：
emcc --version输出需含clang version（≥15 推荐），且编译时加-mllvm --wasm-enable-simd128 - Emscripten 2.0.30+ 可改用更简洁的
-msimd128（等价于上项，推荐） - 若漏掉该 flag，
#include <wasm_simd128.h>能过，但调用v128_load会报undefined symbol: v128_load
头文件、类型和基础向量操作要配对使用
<wasm_simd128.h> 是 WebAssembly 官方 C API，不是 x86 的 xmmintrin.h 翻版——它只提供底层 load/store/shuffle/arith 操作，没有高阶抽象（如 _mm_add_ps）。你得自己组合指令，而且所有操作都作用于 v128_t 这个 opaque 类型。
- 加载数据必须用
v128_load/v128_load32x4等，不能直接 cast 指针：(v128_t*)ptr是未定义行为 - 整数运算注意符号扩展：有符号 8-bit 加法用
i8x16_add，无符号得用u8x16_add（函数名里带u或i） - 浮点运算只有 f32x4 和 f64x2，没有 f16x8；
f32x4_add输入必须是v128_t，不能传float[4]
编译时 target 必须匹配运行时环境
即使编译出含 SIMD 指令的 wasm，浏览器也可能拒绝执行：Chrome ≥91、Firefox ≥93、Safari ≥16.4 才启用 wasm_simd128。Node.js 需 ≥18.16.0 且启动时加 --experimental-wasm-simd。
- 用
WebAssembly.validate(bytes)检查 wasm 二进制是否含合法 SIMD 段（返回 true 才可能跑起来） - 运行时报错
RuntimeError: unreachable executed很可能是 CPU 不支持或 JS 引擎禁用了 SIMD，不是代码逻辑错 - Emscripten 默认生成的 JS loader 会自动检测
navigator.userAgent并 fallback，但 fallback 逻辑不重写你的 C++ SIMD 路径——得自己用#ifdef __wasm_simd128__包裹
性能收益不线性，别盲目向量化
WASM SIMD 的延迟和吞吐和原生不同：比如 f32x4_add 在 V8 中约 1–2 cycle，但内存对齐要求严（v128_load 要求地址 % 16 == 0），未对齐触发 trap；小数组（
立即学习“C++免费学习笔记（深入）”；
- 优先向量化 hot loop，且循环次数 ≥ 16（避免分支预测开销盖过并行收益）
- 避免频繁
v128_store→v128_load组合：WASM 栈模型下，中间结果尽量留在v128_t变量里，别反复进出内存 - 调试时关掉优化：
-O0 -msimd128会导致大量冗余 shuffle，实际应始终用-O2 -msimd128编译
最常被忽略的是：SIMD 向量操作不改变内存布局，int32_t a[4] 和 v128_t 内存布局一致，但你不能假设 reinterpret_cast<v128_t*>(a) 安全——Emscripten 的 ABI 规定 v128_t 是按值传递的，栈对齐由编译器保证，手动指针转换极易破坏。
