添加Swift构建脚本时出现sysroot与目标平台不匹配错误求助

这个错误的核心原因是Xcode构建阶段会自动继承当前项目的构建环境（比如你的项目是针对iOS模拟器的），但直接运行Swift脚本时，脚本默认会以当前Mac的系统架构和版本为目标，两边环境冲突导致标准库加载失败。

下面是几种可行的解决办法：

• 显式指定脚本的目标环境
  调用Swift命令时，直接指定要使用的SDK和目标架构，强制脚本脱离项目的默认环境。比如如果你的脚本是要在macOS环境运行，执行命令改成：

  /usr/bin/swift "${PROJECT_DIR}/BuildScript.swift" -sdk $(xcrun --show-sdk-path --sdk macosx) -target arm64-apple-macosx13.0
  

  要是不需要依赖项目的构建环境，也可以在脚本开头先清除冲突的环境变量：

  unset SDKROOT
  unset DEVELOPER_DIR
  /usr/bin/swift "${PROJECT_DIR}/BuildScript.swift"
  

• 调整构建阶段的环境变量
  进入Xcode的Build Phases找到你的Run Script阶段，点击阶段名称旁的+号，添加环境变量：

  • 变量名：SDKROOT
  • 值：$(xcrun --show-sdk-path --sdk macosx)
    这样脚本会强制使用macOS的SDK，不会再和iOS模拟器的sysroot冲突。

• 预编译脚本为可执行文件（推荐复杂脚本）
  如果你的脚本逻辑较多，建议把BuildScript.swift做成Swift Package编译成可执行文件，再在构建阶段调用：

  1. 在项目外创建一个Swift Package，设置为可执行目标
  2. 执行swift build -c release生成release版本的可执行文件
  3. 在Xcode构建阶段调用该文件路径："${PROJECT_DIR}/../.build/release/YourScriptName"

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