Ubuntu下emcmake构建Qt5 WASM项目的依赖与链接错误求助

一、自动配置Qt5模块路径（解决CMake找不到Qt5Config.cmake） #

你遇到的CMake优先搜索Emscripten sysroot而非指定Qt路径的问题，本质是emcmake会修改CMake的搜索优先级，导致CMAKE_PREFIX_PATH被覆盖或优先级降低。直接用以下方法解决：

1. 显式指定Qt5_DIR（最可靠）
   放弃依赖CMAKE_PREFIX_PATH，直接在cmake命令中指定Qt5Config.cmake所在的目录：

   emcmake cmake .. -DQt5_DIR=/home/oleksiy/Qt/5.15.2/wasm_32/lib/cmake/Qt5
   

   这个参数会强制CMake直接去指定目录查找Qt的配置文件，不受emcmake环境的干扰。

2. 删除无效的CMAKE_MODULE_PATH配置
   你之前添加的set(CMAKE_MODULE_PATH ...)对当前问题无帮助，因为Qt5采用Package Config模式（依赖Qt5Config.cmake），而非Module模式（依赖FindQt5.cmake），直接删掉这行代码即可。

3. 匹配Qt与Emscripten兼容版本
   Qt 5.15.2对Emscripten版本有严格要求，官方推荐使用Emscripten 1.39.18或2.0.12，如果你的Emscripten版本过新，会导致CMake环境异常，建议切换到兼容版本：

   cd /home/oleksiy/Libraries/emsdk
   emsdk install 1.39.18
   emsdk activate 1.39.18
   source ./emsdk_env.sh
   

二、解决Embind链接错误（undefined symbol: _embind_register_function） #

这个错误是因为Emscripten的embind库未被显式链接，需要在CMake配置中添加链接标志：

1. 在CMakeLists.txt中添加embind链接参数
   在add_executable代码块之后，添加以下配置（二选一即可）：

   # 全局设置链接标志
   set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -lembind")
   

   或者更规范的目标级设置：

   # 仅针对当前项目设置
   target_link_options(TestWebAssembly PRIVATE -lembind)
   

   这会强制em++在链接时包含embind库，解决符号未定义问题。

2. 确认embind代码规范
   如果你的代码中用embind暴露C++接口到JS，确保所有相关代码都正确包含<emscripten/bind.h>，无需额外编译标志，仅需链接时加-lembind。

3. 检查Qt模块依赖声明
   确保在find_package中正确声明所有需要的Qt模块，例如：

   find_package(Qt5 REQUIRED COMPONENTS Core Widgets)
   

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