Mac构建arm64/x86_64通用库时如何链接双架构OpenSSL等依赖

你的核心判断是对的：构建 macOS 通用二进制（同时支持 arm64、x86_64）时，所有链接的第三方依赖必须提供对应双架构版本，单架构库混链一定会在链接阶段报架构不匹配错误，你提前准备两套架构隔离的 Homebrew、vcpkg 实例的准备工作完全合理。
但你设想的连续两次调用find_package查找同名包的写法是行不通的：CMake 单次配置流程中，对同名包的find_package调用只会生效一次，不会自动按目标架构拆分链接规则，没法实现两个架构分别绑定不同路径依赖的效果。

这是苹果官方推荐的通用二进制构建流程，完全不需要修改业务层 CMake 逻辑，也不会出现依赖路径冲突，适配所有依赖管理工具，步骤如下：

• 第一步：构建 x86_64 单架构产物，配置时指定对应架构的依赖路径

  cmake -B build_intel -DCMAKE_OSX_ARCHITECTURES=x86_64 \
    -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl@3 \ # Intel 架构 Homebrew 安装的 OpenSSL 默认路径
    -DCMAKE_TOOLCHAIN_FILE=/path/to/your/vcpkg_intel/scripts/buildsystems/vcpkg.cmake # Intel 版 vcpkg 的工具链文件
  cmake --build build_intel
  

• 第二步：构建 arm64 单架构产物，配置时切换为 arm 架构的依赖路径

  cmake -B build_arm -DCMAKE_OSX_ARCHITECTURES=arm64 \
    -DOPENSSL_ROOT_DIR=/opt/homebrew/opt/openssl@3 \ # Arm 架构 Homebrew 安装的 OpenSSL 默认路径
    -DCMAKE_TOOLCHAIN_FILE=/path/to/your/vcpkg_arm/scripts/buildsystems/vcpkg.cmake # Arm 版 vcpkg 的工具链文件
  cmake --build build_arm
  

• 第三步：用系统自带的lipo工具将两个单架构产物合并为通用二进制

  # 不管是静态库、动态库还是可执行文件，都可以用这个命令合并
  lipo -create build_intel/path/to/your_target build_arm/path/to/your_target -output build_universal/your_target
  # 合并后执行以下命令验证架构，正常会输出两个架构标识
  lipo -info build_universal/your_target
  

如果因为项目构建逻辑限制，不能拆分两次构建，需要在单次配置中直接产出通用二进制，就不能依赖find_package自动生成的导入目标，需要手动通过 CMake 生成器表达式按架构拆分链接规则：

1. 保留通用架构配置

   set(CMAKE_OSX_ARCHITECTURES "arm64;x86_64" CACHE INTERNAL "" FORCE)
   

2. 提前定义好两个架构的依赖根路径，通过生成器表达式判断当前编译架构，链接对应版本的库文件

   # 定义双架构依赖根路径
   set(BREW_INTEL_OPENSSL_ROOT "/usr/local/opt/openssl@3")
   set(BREW_ARM_OPENSSL_ROOT "/opt/homebrew/opt/openssl@3")
   set(VCPKG_INTEL_ROOT "/path/to/vcpkg_intel/installed/x64-osx")
   set(VCPKG_ARM_ROOT "/path/to/vcpkg_arm/installed/arm64-osx")
   
   # 头文件一般架构无关，直接引入即可
   target_include_directories(your_app_or_lib PRIVATE
     ${BREW_INTEL_OPENSSL_ROOT}/include
     ${VCPKG_INTEL_ROOT}/include
   )
   
   # 核心：按架构匹配对应版本的依赖库
   target_link_libraries(your_app_or_lib PRIVATE
     # 匹配 OpenSSL
     $<IF:$<STREQUAL:$<TARGET_PROPERTY:OSX_ARCHITECTURES>,x86_64>,
       ${BREW_INTEL_OPENSSL_ROOT}/lib/libssl.a;${BREW_INTEL_OPENSSL_ROOT}/lib/libcrypto.a,
       ${BREW_ARM_OPENSSL_ROOT}/lib/libssl.a;${BREW_ARM_OPENSSL_ROOT}/lib/libcrypto.a
     >
     # 匹配 vcpkg 安装的 zlib
     $<IF:$<STREQUAL:$<TARGET_PROPERTY:OSX_ARCHITECTURES>,x86_64>,
       ${VCPKG_INTEL_ROOT}/lib/libz.a,
       ${VCPKG_ARM_ROOT}/lib/libz.a
     >
   )
   

注意：这个方案维护成本很高，你需要手动枚举所有依赖（包括间接依赖）的全路径，一旦依赖新增间接链接库就要同步修改配置，非特殊场景不推荐使用。

• 不要尝试把两个单架构的依赖库先手动合并成通用库再做单次构建，虽然技术上可以用lipo实现，但Homebrew、vcpkg安装的依赖数量多、路径散，手动合并的成本远高于分构建再合并最终产物的方案。
• 构建完成后一定要用lipo -info 产物路径、otool -L 产物路径检查架构和依赖链接情况，避免出现漏链、错链单架构库的问题。
• 所有参与链接的依赖（包括间接依赖）必须同时提供arm64和x86_64版本，只要有一个依赖是单架构，最终链接一定会失败。

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