更新Mac后构建Go应用报错'TARGET_OS_IPHONE'未定义如何解决？

报错原因 #

这个问题是Mac系统升级后，Xcode命令行工具自带的Clang编译器版本更新带来的兼容性问题：

• 新版Clang默认开启了-Werror,-Wundef-prefix=TARGET_OS_检查规则，遇到未定义的TARGET_OS_开头的宏会直接抛错误终止编译
• Go 1.19之前的版本的runtime/cgo模块没有适配这个规则，引用系统stdio.h头文件时用到的TARGET_OS_IPHONE宏未提前定义，直接触发了编译器的错误检查

可行解决方案 #

按优先级从高到低排序：

• 方案1：升级Go版本
  升级到Go 1.19及以上的官方稳定版本，该版本已经官方修复了和新版Mac工具链的兼容性问题，升级后直接重新构建即可，是最稳妥的方案。
• 方案2：临时添加编译参数忽略警告
  如果暂时无法升级Go版本，构建时添加CGO编译参数跳过该类错误检查，命令示例：

  CGO_CFLAGS="-Wno-error=undef-prefix" go build
  

• 方案3：全局配置环境变量永久生效
  不想每次构建都加参数的话，把对应环境变量写入你的shell配置文件（_/.zshrc、/.bash_profile等）：

  export CGO_CFLAGS="-Wno-error=undef-prefix"
  

  执行source ~/.zshrc（对应你实际使用的shell配置文件）后生效，后续所有go构建都会自动带上该参数。
• 方案4：重置Xcode命令行工具路径
  如果上述方案都无效，可能是系统升级后Xcode命令行工具的路径偏移导致的，执行以下命令重置路径即可：

  sudo xcode-select --switch /Library/Developer/CommandLineTools
  

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