SwiftUI预览在macOS构建时失效但iOS构建正常如何解决

1. 校验文件的Target Membership配置 #

• 选中报错的Swift源码文件，按下快捷键Option + Command + 1打开右侧文件检查器面板
• 找到「Target Membership」区域，确认你正在构建的macOS target处于勾选状态，未勾选则手动勾选后重新编译项目即可解决大部分文件未加入构建的问题

2. 修正Scheme构建配置 #

• 点击Xcode顶部的scheme选择下拉框，选择「Edit Scheme」
• 切换到Build标签页，确认macOS target已被加入构建列表，同时开启「Find Implicit Dependencies」选项
• 确认所有公共组件、被当前视图引用的其他文件，也都同时加入了macOS target的构建成员

3. 适配跨平台代码逻辑 #

如果你在视图定义代码中使用了#if os(iOS)这类仅iOS平台的条件编译，切换到macOS构建时视图代码会被编译器自动忽略，直接触发作用域找不到视图的报错

• 检查你的视图定义代码，确认核心视图逻辑没有被仅iOS的条件编译包裹，如需分平台适配，补充os(macOS)的分支逻辑
• 预览代码也需要同步适配多平台，参考写法：

struct CustomView_Previews: PreviewProvider {
    static var previews: some View {
        #if os(iOS)
        CustomView()
            .previewDevice("iPhone 15")
        #elseif os(macOS)
        CustomView()
            .frame(width: 500, height: 300)
        #endif
    }
}

注意：如果项目引入了第三方依赖，需要确认对应依赖支持macOS平台，否则也会触发构建错误导致预览无法加载

4. 清理Xcode缓存（上述操作无效时执行） #

• 完全关闭Xcode，打开终端执行命令删除构建缓存：rm -rf ~/Library/Developer/Xcode/DerivedData
• 重新打开Xcode，等待项目索引完成后再切换macOS target尝试构建预览

内容的提问来源于stack exchange，提问作者Satya Prakash Sahu