如何用Emscripten将无Configure的Makefile C++项目编译为WASM

方案1：通过环境变量覆盖编译工具（最小改动，无需修改项目文件） #

1. 先确保Emscripten环境已正确激活：
   • Linux/macOS：source emsdk_env.sh
   • Windows：emsdk_env.bat
2. 执行构建时，直接通过环境变量指定Emscripten的编译工具，同时传递SIMD相关参数：

   emmake make CC=emcc CXX=em++ CFLAGS="-msimd128 -mrelaxed-simd" CXXFLAGS="-msimd128 -mrelaxed-simd" LDFLAGS="-msimd128 -mrelaxed-simd"
   

   解释：
   • emmake 用来包装make命令，确保构建环境继承Emscripten的配置
   • CC=emcc/CXX=em++ 强制替换项目Makefile中的默认编译器
   • -msimd128 启用WebAssembly SIMD 128支持，-mrelaxed-simd 放宽SIMD指令的兼容性约束，适配部分x86 SIMD代码转换

方案2：迁移到CMake构建（长期维护更友好） #

如果项目后续需要频繁适配WASM，建议迁移到CMake：

1. 在项目根目录创建CMakeLists.txt，根据项目结构调整内容：

   cmake_minimum_required(VERSION 3.18)
   project(Zilch)
   
   # 收集所有源文件（大项目建议手动列出源文件替代GLOB，避免遗漏或误匹配）
   file(GLOB_RECURSE PROJECT_SOURCES src/*.cpp src/*.c)
   # 添加头文件目录
   include_directories(include)
   
   # 创建可执行目标（如果是库则用add_library）
   add_executable(zilch ${PROJECT_SOURCES})
   
   # 配置SIMD编译/链接参数
   target_compile_options(zilch PRIVATE -msimd128 -mrelaxed-simd)
   target_link_options(zilch PRIVATE -msimd128 -mrelaxed-simd)
   

2. 执行Emscripten构建流程：

   mkdir build-wasm && cd build-wasm
   emcmake cmake ..
   emmake make
   

方案3：手动编译（适合小型项目） #

如果项目源文件不多，可直接用emcc/em++手动编译：

1. 编译单个源文件为WASM目标文件：

   emcc -c src/your_file.cpp -o your_file.o -msimd128 -mrelaxed-simd -Iinclude
   

2. 链接所有目标文件生成WASM模块：

   emcc *.o -o zilch.wasm -msimd128 -mrelaxed-simd
   

常见问题排查 #

• SIMD错误仍存在：查看具体错误信息，若提示某类x86 SIMD指令无法转换，需在项目代码中添加条件编译：

  #ifdef __EMSCRIPTEN__
  // WASM兼容的代码实现
  #else
  // 原x86 SIMD代码
  #endif
  

• Emscripten版本问题：旧版本对SIMD支持不完善，执行emsdk install latest && emsdk activate latest更新到最新版
• 环境未激活：确保每次构建前都激活了Emscripten环境，否则emcc/emmake可能无法正确调用

内容的提问来源于stack exchange，提问作者Johannes Mols