如何在Intel机器上为多版本macOS编译通用Apple Silicon M1二进制文件？

核心结论 #

不存在能直接覆盖所有macOS版本的“通用-target参数”，但通过指定最低兼容系统版本+API版本适配，可以让编译出的二进制在macOS 11、12及未来兼容arm64的版本上运行。

纠正一个常见误解 #

你提到的-target arm64-apple-macos11并非只能在macOS 11上运行——这个参数里的版本号是最低部署版本（Minimum Deployment Target），意思是程序可以在macOS 11及所有更高版本（包括12、13甚至未来版本）上正常运行。你觉得它无法适配macOS 12，大概率是因为代码中直接调用了macOS 12才新增的API，却没有做版本兼容处理，导致程序运行异常。

正确的通用兼容方案 #

1. 设定统一的最低部署版本 #

编译时指定你需要支持的最老macOS版本作为目标，比如要兼容macOS 11及以上，使用：

-target arm64-apple-macos11

或者单独指定最低版本参数（clang中与上述-target参数效果一致）：

-mmacosx-version-min=11.0

这样生成的二进制会自动被所有高于macOS 11的系统兼容，包括未来的版本（只要苹果保留arm64架构和旧API的兼容层）。

2. 对高版本API做兼容处理 #

如果代码中需要调用macOS 12及以上才有的API，必须通过弱链接或条件编译做兼容：

• 使用Objective-C的@available语法（C++中可兼容使用）：

  #include <AvailabilityMacros.h>
  
  void some_function() {
      if (@available(macOS 12.0, *)) {
          // 仅在macOS 12及以上调用新API
          call_macos12_only_api();
      } else {
          // 老系统的替代实现
          call_legacy_api();
      }
  }
  

• 或者使用预处理宏判断系统版本：

  #include <TargetConditionals.h>
  
  void some_function() {
  #if MAC_OS_X_VERSION_MIN_REQUIRED >= 120000
      call_macos12_only_api();
  #else
      call_legacy_api();
  #endif
  }
  

额外注意事项 #

• 编译时确保使用的SDK版本不低于你设定的最低部署版本，但不需要匹配目标系统的最高版本——Xcode的默认SDK会包含多版本API的定义，配合弱链接就能实现跨版本兼容。
• 未来如果苹果推出新的macOS版本，只要你的程序没有依赖该版本专属且无兼容层的API，基于macOS 11最低版本编译的二进制依然可以正常运行。

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