编译的x86 macOS静态库被识别为iPhone模拟器库，如何生成正确二进制？

问题 #

尝试为Darwin平台构建Cgo库，目标生成包含macOS和iOS（x86、arm64架构）版本的xcframework。当前构建命令如下：

CGO_ENABLED=1 \
GOOS=darwin \
GOARCH=amd64 \
SDK=macosx \
CC=$(ROOT_DIR)clangwrap.sh \
go build -buildmode=c-archive -tags ios -o $(MACOS_OUT)/x86_64/mylib.a .

使用的clangwrap.sh脚本内容：

SDK_PATH=`xcrun --sdk $SDK --show-sdk-path`
CLANG=`xcrun --sdk $SDK --find clang`

if [ "$GOARCH" == "amd64" ]; then
    CARCH="x86_64"
elif [ "$GOARCH" == "arm64" ]; then
    CARCH="arm64"
fi

MIN_VERSION=""
if [ "$SDK" == "macosx" ]; then
    MIN_VERSION="-mmacosx-version-min=10.15"
elif [ "$SDK" == "iphoneos" ] || [ "$SDK" == "iphonesimulator" ]; then
    MIN_VERSION="-mios-version-min=10.0"
fi

exec $CLANG -arch $CARCH -isysroot $SDK_PATH $MIN_VERSION "$@"

执行xcodebuild -create-xcframework时提示存在重复的x86-ios-simulator库，用otool查看macOS二进制发现被识别为iOS二进制：

> otool -l lib/darwin/macos/x86_64/mylib.a
Load command 1
      cmd LC_VERSION_MIN_IPHONEOS
  cmdsize 16
  version 10.0
      sdk 15.2
Load command 2
     cmd LC_SYMTAB
 cmdsize 24
  symoff 6312
   nsyms 9
  stroff 6456
 strsize 184

需要解决如何生成正确的macOS二进制文件的问题。

解决方法 #

1. 移除macOS构建命令中的-tags ios标签 #

构建macOS版本时，ios标签会让Go工具链默认加载iOS相关编译配置，覆盖你在clangwrap.sh中设置的macOS参数。修改后的macOS构建命令：

CGO_ENABLED=1 \
GOOS=darwin \
GOARCH=amd64 \
SDK=macosx \
CC=$(ROOT_DIR)clangwrap.sh \
go build -buildmode=c-archive -o $(MACOS_OUT)/x86_64/mylib.a .

2. 验证clangwrap.sh参数生效 #

检查脚本中MIN_VERSION的判断逻辑，确认macOS对应的-mmacosx-version-min=10.15参数被正确传入。同时验证macOS SDK路径是否正确：

xcrun --sdk macosx --show-sdk-path

确保输出指向macOS的SDK目录，而非iOS/模拟器SDK。

3. 重新构建后验证二进制平台信息 #

重新编译后，用otool检查二进制的加载命令，确认出现LC_VERSION_MIN_MACOSX而非LC_VERSION_MIN_IPHONEOS：

otool -l lib/darwin/macos/x86_64/mylib.a | grep -A 3 LC_VERSION_MIN

正确输出示例：

Load command 1
      cmd LC_VERSION_MIN_MACOSX
  cmdsize 16
  version 10.15
      sdk 15.2

4. 分开配置iOS和macOS构建流程 #

为避免参数混淆，建议将两类平台的构建命令完全分离：

• iOS模拟器（x86_64）：指定SDK=iphonesimulator，保留-tags ios
• iOS真机（arm64）：指定SDK=iphoneos，保留-tags ios
• macOS（x86_64/arm64）：指定SDK=macosx，移除-tags ios

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