GitHub Actions构建iOS项目报错：找不到匹配的模拟器目标

这个报错和本地代码、本地构建逻辑没有关系，核心是两个问题：

1. GitHub Actions的macos-latest镜像随版本迭代，预装的Xcode和iOS模拟器一直在更新，目前搭载Xcode 15的镜像里只预装了iOS 17对应的iPhone 14、iPhone 15系列模拟器，根本不存在报错里提到的iPhone 11设备。
2. 你用的是GitHub官方过时的iOS starter工作流，里面的设备抓取逻辑有bug：用xcrun xctrace list devices的输出做正则匹配，会把未创建、未安装的无效设备条目也提取出来，最终传给xcodebuild的设备名本身就是环境里不存在的，自然每次都报找不到目标的错。哪怕手动改设备名，只要没对应上当前镜像预装的机型，都会报一模一样的错。

方案1：通用兼容写法（最省事，不用关心Runner预装了什么机型） #

不要硬匹配具体设备名，直接用通用目标让Xcode自动选择可用模拟器，把原有Build、Test步骤的run段替换成下面的内容即可：

- name: Build
  env:
    scheme: ${{ 'default' }}
    platform: ${{ 'iOS Simulator' }}
  run: |
    if [ $scheme = default ]; then scheme=$(cat default); fi
    if [ "`ls -A | grep -i \\.xcworkspace\$`" ]; then filetype_parameter="workspace" && file_to_build="`ls -A | grep -i \\.xcworkspace\$`"; else filetype_parameter="project" && file_to_build="`ls -A | grep -i \\.xcodeproj\$`"; fi
    file_to_build=`echo $file_to_build | awk '{$1=$1;print}'`
    xcodebuild build-for-testing -scheme "$scheme" -"$filetype_parameter" "$file_to_build" -destination "generic/platform=iOS Simulator" CODE_SIGNING_ALLOWED=NO

- name: Test
  env:
    scheme: ${{ 'default' }}
    platform: ${{ 'iOS Simulator' }}
  run: |
    if [ $scheme = default ]; then scheme=$(cat default); fi
    if [ "`ls -A | grep -i \\.xcworkspace\$`" ]; then filetype_parameter="workspace" && file_to_build="`ls -A | grep -i \\.xcworkspace\$`"; else filetype_parameter="project" && file_to_build="`ls -A | grep -i \\.xcodeproj\$`"; fi
    file_to_build=`echo $file_to_build | awk '{$1=$1;print}'`
    xcodebuild test-without-building -scheme "$scheme" -"$filetype_parameter" "$file_to_build" -destination "platform=$platform,OS=latest,name=iPhone" CODE_SIGNING_ALLOWED=NO

这里加CODE_SIGNING_ALLOWED=NO是为了跳过CI环境下不必要的签名校验，避免额外的签名报错，纯模拟器构建测试不需要证书签名。

方案2：固定指定测试机型（需要固定测试设备时用） #

如果必须用特定机型跑测试，不要用xctrace抓设备列表，换用simctl命令筛选真实可用、已经完成创建的模拟器，通过设备ID指定目标，完全避免名称匹配的问题：

# 示例：获取最新iOS系统下可用的iPhone 15（非Pro版）的设备ID
device_id=$(xcrun simctl list devices available iOS | grep "iPhone 15 (" | grep -v "Pro" | head -1 | awk -F'[()]' '{print $2}')
# 构建/测试时直接传id参数
xcodebuild test-without-building -scheme "$scheme" -"$filetype_parameter" "$file_to_build" -destination "platform=$platform,id=$device_id" CODE_SIGNING_ALLOWED=NO

如果改完还是有问题，在Build步骤前加一个调试步骤，打印当前Runner的真实环境信息，就能直接看到当前环境到底有哪些可用设备，不需要盲目排查：

- name: Print Runner Env Info
  run: |
    echo "=== Xcode Version ==="
    xcodebuild -version
    echo "=== Available Simulators ==="
    xcrun simctl list devices available

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