PAYATHON 2026

Xcode 15.3 调试时运行旧版 iOS executable

排障赵师傅

结论

问题更可能出在 Xcode 15.3 与 macOS 14.4:使用 My Mac (Designed for iPhone / iPad) 作为运行目标时,构建、安装或进程启动的缓存可能出现异常。Swift 代码本身通常不是原因,Swift Compiler - Compilation Mode 保持 Incremental 也没有问题,无需为了处理这次故障长期改成 Whole Module。

建议先将 macOS 和 Xcode 升级到当前可用且互相兼容的补丁版本。暂时无法升级时,改用 physical device 或 iOS Simulator 通常更稳定。如果必须使用该 destination,可以删除当前项目的 Derived Data,再重新安装应用。问题仍然存在时,可暂时通过 Clean Build Folder 规避。

现有信息只表明该问题与 macOS 14.4 有较强关联,还不足以认定 Apple 已确认具体根因。

检查 Scheme 配置

打开:

Product > Scheme > Edit Scheme

在 Build 页面确认当前应用 Target 已勾选 Run,再检查:

Run > Info > Build Configuration

这里通常应设置为 Debug,并启用 Debug executable。

如果 Scheme 没有构建应用 Target,Xcode 可能直接启动上一次生成的 .app。但如果新建项目也能稳定复现,Scheme 配置错误的可能性就比较低。

清理当前项目的 Derived Data

先退出正在运行的应用,然后关闭 Xcode。通过以下入口找到当前项目的 Derived Data:

Xcode > Settings > Locations > Derived Data

点击路径右侧的箭头,在 Finder 中删除当前项目对应的目录即可。先不要删除整个 DerivedData,否则所有项目都要重新建立索引和依赖缓存。

还可以用命令查看构建设置,确认 Xcode 实际使用的输出目录:

xcodebuild \
  -scheme "YourScheme" \
  -configuration Debug \
  -showBuildSettings

重点检查:

TARGET_BUILD_DIR
BUILT_PRODUCTS_DIR
EXECUTABLE_PATH
CONFIGURATION_BUILD_DIR

如果这些路径指向意外的配置或旧目录,继续检查项目中的自定义 Build Settings、.xcconfig 和 Scheme。

可以用下面的命令清理当前 Scheme:

xcodebuild \
  -scheme "YourScheme" \
  -configuration Debug \
  -destination "platform=macOS,variant=Designed for [iPhone,iPad]" \
  clean

不同版本的 Xcode 可能会显示不同的 destination 字符串。先查询本机可用目标:

xcodebuild -scheme "YourScheme" -showdestinations

再复制输出中的 destination 参数。

删除 Mac 上已有的应用副本

My Mac (Designed for iPhone / iPad) 会直接在 Mac 上运行 iOS 应用。如果系统一直启动已安装或缓存的副本,可按以下顺序处理:

  1. 停止 Xcode 中的调试会话。
  2. 确认应用进程已经退出。
  3. 删除 Mac 上现有的应用副本。
  4. 删除当前项目的 Derived Data。
  5. 重新打开 Xcode,执行一次 Product > Clean Build Folder。
  6. 再次 Build and Run。

如果应用配置了后台任务、菜单栏入口或其他常驻行为,还要在“活动监视器”中确认旧进程已经结束。旧进程仍在运行时,看起来会像是 Xcode 再次启动了旧 executable。

临时切换编译模式

在 Debug 配置中找到:

Swift Compiler - Code Generation
Compilation Mode

将:

Incremental

临时改为:

Whole Module

如果切换后问题消失,异常可能出在增量构建或产物复用阶段。这个设置适合用于诊断或临时规避,不能说明原来的 Incremental 配置有误。由于 Whole Module 可能延长 Debug 构建时间,没有必要时不建议长期使用。

测试完成后,将设置恢复为:

SWIFT_COMPILATION_MODE = incremental

确认实际启动的版本

不要只根据界面变化判断,可以临时加入清晰的构建标记:

#if DEBUG
print("Debug marker: 2026-10-28-A")
print("Executable:", Bundle.main.executableURL?.path ?? "unknown")
print("Bundle:", Bundle.main.bundleURL.path)
#endif

每次修改 Debug marker 后重新运行。如果控制台仍显示旧标记,而且 executable 路径没有变化,就可以确认当前运行的是旧构建产物,排除 UI 状态、持久化数据或条件编译造成的假象。

同时检查源文件的 Target Membership。只有某个文件的修改不生效时,该文件可能没有加入当前 Target。如果所有新建项目和代码修改都不生效,则更符合 Xcode/macOS 缓存异常的表现。

问题持续复现时

在问题修复前,可按以下优先级处理:

  1. 更新到较新的兼容版 macOS 和 Xcode。
  2. 改用 physical device。
  3. 改用 iOS Simulator。
  4. 必须使用 My Mac (Designed for iPhone / iPad) 时,每次修改代码后执行 Product > Clean Build Folder。
  5. 向 Apple 提交 Feedback,并附上 Xcode 生成的诊断信息和最小复现项目。

提交反馈时建议写明:

macOS version
Xcode version and build number
Mac model and processor
Selected destination
Scheme and build configuration
Whether a new empty project reproduces the issue
Whether physical device and Simulator reproduce the issue

删除整个 Derived Data、关闭增量编译以及每次运行前执行 clean 都只适合作为临时规避措施。长期这样处理会明显拖慢日常构建。

备注:内容仅供参考。