WebAssembly可使C++加解密算法在浏览器中接近原生性能运行，需满足无系统调用、静态链接等条件；通过Emscripten编译、正确内存管理、跨平台字节序处理及安全边界控制实现高效安全调用。
WebAssembly（Wasm）能让 C++ 编写的加解密算法在浏览器中接近原生性能运行，关键不在于“无缝”，而在于正确桥接、内存安全和接口对齐。真正无缝的前提是：算法无系统调用、无文件 I/O、无线程阻塞、且所有依赖可静态链接。
1. 用 Emscripten 编译 C++ 算法为 Wasm 模块
选择 Emscripten 是当前最成熟路径。它把 C++ 编译为 Wasm + JS 胶水代码，自动处理内存管理与导出函数绑定。
- 确保算法代码纯计算、无全局状态或随机种子硬编码（如使用
srand(time(0))会失效）；改用 Web 提供的熵源（如crypto.getRandomValues()）传入 - 用
EMSCRIPTEN_KEEPALIVE标记需暴露给 JS 的函数，例如：
extern "C" {
EMSCRIPTEN_KEEPALIVE
int aes_encrypt(const uint8_t* input, int len, uint8_t* output);
} - 编译命令示例：
em++ -O3 --bind --no-entry -s EXPORTED_FUNCTIONS='["_aes_encrypt","_aes_decrypt"]' -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]' -o crypto.js crypto.cpp
2. 在浏览器中加载并调用 Wasm 模块
现代方式推荐使用 Emscripten 生成的异步初始化（instantiateStreaming），避免胶水代码阻塞主线程。
- 加载后通过
Module.ccall()或Module.cwrap()调用函数，注意参数类型匹配：
const encrypt = Module.cwrap('aes_encrypt', 'number', ['number', 'number', 'number']);
const inputPtr = Module._malloc(input.length);
Module.HEAPU8.set(input, inputPtr);
const outputPtr = Module._malloc(input.length);
const result = encrypt(inputPtr, input.length, outputPtr); - 务必手动
Module._free()释放分配的内存，否则造成内存泄漏 - 若算法需多次调用，建议封装成类，统一管理内存生命周期
3. 处理密钥、IV 和字节序等跨平台细节
C++ 默认按小端、原始字节操作；JS 的 Uint8Array 也是小端，但加密协议（如 AES-CBC）常要求特定 IV 格式或 PKCS#7 填充——这些必须在 C++ 层实现，不能依赖 JS 补充。
立即学习“C++免费学习笔记（深入）”；
- 密钥/IV 不要以字符串形式传入 C++，应统一用
Uint8Array→Module.HEAPU8内存拷贝 - 避免在 C++ 中直接读写 JS 字符串（如
std::string含 null 终止符，易截断二进制密钥） - 输出结果建议返回长度+指针，由 JS 拷贝为新
Uint8Array，防止 Wasm 内存被后续操作覆盖
4. 性能与安全边界提醒
Wasm 加解密虽快，但不改变浏览器环境本质：密钥仍暴露在内存中，无法防调试器提取；且无法替代服务端验证。
- 敏感密钥（如用户主密钥）不应从 JS 传入，建议用 Web Crypto API 生成/导入，再导出为 raw bytes 送入 Wasm
- 对大文件（>10MB）加解密，考虑分块处理 +
Web Worker避免界面卡顿 - 启用 Emscripten 的
-s STACK_SIZE=1MB防止栈溢出（尤其递归或大局部数组场景）
