Apple M1 macOS下CMake引入libgit2 v1.5.0出现链接错误求助

可能的原因与对应解决方案 #

1. libgit2 v1.5.0新增依赖未被链接 #

从v1.3.0到v1.5.0，libgit2新增了部分组件依赖，你的CMake配置未同步引入这些依赖：

• 查看libgit2 v1.5.0的CMake配置输出，确认启用的组件（如USE_SSH、USE_HTTPS），这些组件需要额外链接系统库（libssh2、libssl、libcrypto等）。
• 修改项目CMakeLists.txt，在链接libgit2目标时添加对应依赖。比如启用HTTPS时：

  target_link_libraries(你的项目名称 PRIVATE git2 OpenSSL::SSL OpenSSL::Crypto)
  

2. 架构不匹配（arm64/x86_64） #

M1为arm64架构，若libgit2与项目编译架构不一致，会导致符号不匹配：

• 在CMake配置阶段强制指定arm64架构：

  set(CMAKE_OSX_ARCHITECTURES "arm64" CACHE STRING "Build architecture")
  

• 清空所有构建目录（包括libgit2自身的build文件夹），重新执行CMake配置与构建，确保两者架构统一。

3. libgit2 CMake构建选项变更 #

v1.5.0调整了部分CMake默认选项，比如目标名、静态/动态库默认设置：

• 确认正确引入libgit2的CMake目标，新版本通常使用git2作为目标名：

  add_subdirectory(你的libgit2源码路径)
  target_link_libraries(你的项目名称 PRIVATE git2)
  

• 若项目为静态构建，需强制libgit2编译为静态库：

  set(BUILD_SHARED_LIBS OFF CACHE BOOL "Build shared libraries" FORCE)
  add_subdirectory(你的libgit2源码路径)
  

4. macOS SDK版本兼容性问题 #

Monterey系统的部分系统库版本与libgit2 v1.5.0预期不匹配：

• 在CMake中指定兼容的SDK路径（替换为你本地Xcode对应的SDK版本）：

  set(CMAKE_OSX_SYSROOT "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX12.3.sdk" CACHE STRING "macOS SDK path")
  

• 更新Xcode至Monterey兼容的最新版本，确保系统头文件与库完整。

5. 清理构建缓存 #

旧版本的构建缓存残留可能干扰新版本编译：

• 删除CLion自动生成的cmake-build-*文件夹，以及libgit2源码目录下的build文件夹。
• 重启CLion，重新加载CMake配置后再执行构建。

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