XCode 15.3预览功能陷入循环构建，无法正常使用求助

问题描述 #

在为应用开发Widget时，Xcode Preview功能出现异常：Xcode陷入持续构建循环，反复执行构建操作但无任何错误提示，预览窗口始终显示加载spinner，等待多久都无法完成预览。已尝试以下操作但未解决问题：

• 清理构建文件夹（快捷键Cmd+Shift+K）
• 删除所有预览模拟器
• 重启Xcode

相关截图：

• 构建日志：
• 预览窗口状态：

可行解决方法 #

• 检查TimelineProvider回调逻辑：重点排查getTimeline(in:completion:)方法，确保方法内正确调用了completion闭包，不存在无限递归、异步任务挂起等情况——这类问题会导致预览持续触发刷新，进而引发构建循环。同时确认placeholder(in:)和getSnapshot(in:completion:)也能正常完成执行。
• 验证Widget配置与Intent：如果使用IntentConfiguration配置Widget，检查Intent的定义是否存在参数错误（比如默认值不合法、类型不匹配），这类配置问题可能触发预览反复重建。
• 彻底清理DerivedData缓存：手动删除项目对应的DerivedData文件夹（路径：~/Library/Developer/Xcode/DerivedData），清除深层编译缓存后重启Xcode。
• 调整Build Settings：确认Widget Target的Build Active Architecture Only在Debug模式下设置为Yes，避免不必要的多架构编译导致循环。
• 测试空白Widget：新建一个空白Widget Target，测试预览是否正常。如果空白Widget能正常显示，说明原Widget代码存在逻辑问题，可逐步对比代码排查差异。
• 升级Xcode版本：部分旧版本Xcode存在预览功能的已知bug，升级到最新稳定版可能直接解决问题。

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