如何解决Xcode SwiftUI项目中的‘PREVIEW UPDATE ERROR’预览更新错误？

核心原因 #

Xcode 14.3.1的SwiftUI预览系统对#if DEBUG条件编译的处理存在兼容性问题，手动用该宏包裹预览提供者结构体，会导致预览系统无法正确识别并编译这段代码，从而抛出找不到预览提供者的错误。

解决步骤 #

1. 移除条件编译宏
   直接删除#if DEBUG和#endif，让预览结构体和主视图结构体处于同一层级，修改后的代码如下：

   import SwiftUI
   
   struct ContentView: View {
       var body: some View {
           VStack {
               Text("Hello, world!")
           }
           .padding()
       }
   }
   
   struct ContentView_Previews: PreviewProvider {
       static var previews: some View {
           ContentView()
       }
   }
   

2. 验证文件的目标归属

   • 在项目导航栏选中ContentView.swift文件
   • 查看右侧面板的Target Membership，确保勾选了当前项目的主应用目标，避免文件未被纳入编译范围。

3. 清理缓存并重建

   • 按下Cmd+Shift+K清理构建文件夹
   • 关闭Xcode，删除~/Library/Developer/Xcode/DerivedData路径下的所有文件（这是Xcode的缓存目录）
   • 重新打开Xcode，点击预览面板的"重新加载"按钮，或重新构建项目。

4. 确认编译条件配置
   检查项目的Build Settings：

   • 搜索Active Compilation Conditions
   • 确保DEBUG配置下包含DEBUG宏（默认配置已包含，无需额外修改，仅作确认）

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