Mac平台下C++项目链接Mono时出现链接器错误

问题背景 #

在Mac平台使用CMake将Mono接入C/C++项目时，编译环节正常，但链接阶段报错，提示Undefined symbols for architecture arm64，同时伴随忽略不兼容动态库的警告。

疑问解答 #

1. CMake区分动态/静态链接及静态链接配置方法 #

CMake默认优先选择动态库（.dylib/.so）进行链接，若要强制静态链接指定的libmono-2.0.a，可通过以下方式实现：

• 直接指定静态库路径（最可靠）
  跳过pkg_check_modules返回的默认库列表，直接在target_link_libraries中写入静态库的完整路径：

  # 替换原有target_link_libraries行
  target_link_libraries(${PROJECT_NAME} PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}/libraries/MacOS/Mono.framework/Versions/Current/lib/libmono-2.0.a")
  

  这种方式能确保CMake精准链接你指定的静态库。

• 通过pkgconfig强制静态链接
  若想继续使用pkg_check_modules，可设置环境变量让pkgconfig优先返回静态库：

  set(ENV{PKG_CONFIG_STATIC} "1")
  pkg_check_modules(MONO REQUIRED mono-2)
  

  此操作会让MONO_LIBRARIES指向静态库，但需确保Mono的.pc配置文件中正确声明了静态库路径。

• 静态链接额外依赖补充
  静态链接Mono时通常需要额外链接系统依赖库，可在链接时添加：

  target_link_libraries(${PROJECT_NAME} PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}/libraries/MacOS/Mono.framework/Versions/Current/lib/libmono-2.0.a" pthread dl)
  

2. 忽略dylib警告的原因及与链接错误的关联 #

• 警告原因：你的设备是Apple Silicon Mac（arm64架构），但当前使用的libmono-2.0.dylib仅包含i386和x86_64架构，完全不兼容arm64，因此链接器ld会直接忽略这个无效的动态库。
• 与链接错误的关系：是直接原因。CMake默认尝试链接动态库，而该动态库因架构不兼容被忽略；若pkgconfig未正确返回arm64架构的静态库，链接器找不到对应架构下的_mono_jit_init符号，就会触发未定义符号错误。

额外建议 #

• 验证静态库是否包含arm64架构，可执行以下命令：

  lipo -info /Users/mickey/Documents/GitHub/IgnisEngine/libraries/MacOS/Mono.framework/Versions/6.12.0/lib/libmono-2.0.a
  

  若静态库也无arm64架构，需重新编译支持arm64的Mono版本，或更换包含universal架构的Mono包。
• 若倾向动态链接，需替换为支持arm64架构的libmono-2.0.dylib。

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