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 应用。如果系统一直启动已安装或缓存的副本,可按以下顺序处理:
- 停止 Xcode 中的调试会话。
- 确认应用进程已经退出。
- 删除 Mac 上现有的应用副本。
- 删除当前项目的 Derived Data。
- 重新打开 Xcode,执行一次
Product > Clean Build Folder。 - 再次 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 缓存异常的表现。
问题持续复现时
在问题修复前,可按以下优先级处理:
- 更新到较新的兼容版 macOS 和 Xcode。
- 改用 physical device。
- 改用 iOS Simulator。
- 必须使用
My Mac (Designed for iPhone / iPad)时,每次修改代码后执行Product > Clean Build Folder。 - 向 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 都只适合作为临时规避措施。长期这样处理会明显拖慢日常构建。
备注:内容仅供参考。
