CMake项目引入GMP库链接时报x86_64架构未定义符号错误如何解决

问题根因 #

报错的未定义符号经解析为GMP C++接口的输出流运算符，属于libgmpxx的导出符号，出现该问题的常见原因如下：

• 链接顺序错误：ld链接器按从左到右的顺序解析符号依赖，依赖方需放在被依赖方左侧。你当前配置中先写C核心库gmp、再写C++接口库gmpxx，而gmpxx依赖gmp，顺序错误会导致依赖无法被正确解析。
• 编译器不兼容：你项目指定使用GNU g作为编译器，若项目中存放的预编译GMP库是Mac默认的clang编译生成的，两种编译器的C符号修饰规则不同，会导致符号无法识别。
• 架构不匹配：报错提示x86_64架构符号缺失，若你存放的GMP库是arm64架构编译的，和当前编译的目标架构不匹配也会触发该错误。

可行解决方案 #

方案1：使用系统包管理器安装GMP（推荐，兼容性最高） #

1. 用Homebrew安装适配当前系统架构和编译器的GMP库：

   brew install gmp
   

2. 删除项目目录下预存放的include/gmp文件夹，修改app/CMakeLists.txt配置：
   • 删除target_link_directories、target_include_directories中与GMP相关的手动路径配置
   • 调整target_link_libraries的库顺序：

   target_link_libraries(${PROJECT_NAME} PUBLIC
     gmpxx
     gmp
   )
   

3. 清除旧构建缓存重新编译：

   cd build && rm -rf * && cmake .. && make -j12
   

方案2：修复项目预存GMP库的配置 #

如果你必须使用项目自带的预编译GMP库，按以下步骤调整：

1. 首先调整app/CMakeLists.txt中的链接顺序，将gmpxx放在gmp之前。
2. 验证库架构是否匹配：
   执行以下命令检查自带GMP库的架构：

   lipo -info 你的项目路径/include/gmp/lib/libgmpxx.a
   

   输出内容需包含x86_64，如果只有arm64说明架构不匹配，需替换为x86_64版本的GMP库。
3. 若架构匹配仍报错，说明库的编译器不兼容，删除根目录CMakeLists.txt中set(CMAKE_CXX_COMPILER "/usr/local/bin/g++")的配置，改用Mac默认的clang++编译项目即可。

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