Xcode 13 RC下单项目无法运行SwiftUI预览，报CompileSwiftSources非零退出码

1. 获取完整报错日志 #

触发SwiftUI预览并出现报错后，按以下步骤查看详细日志：

• 点击Xcode左侧导航栏最右侧的*报告导航器（Report Navigator）*图标
• 在构建记录列表中找到本次带「Previews」后缀的预览构建条目，点击进入详情页
• 找到标红的CompileSwiftSources步骤，点击展开就能看到完整的底层报错内容，常规运行时不会触发的编译冲突、依赖适配问题、预览专属配置错误都会在这里明确标注。

2. 常规缓存与配置排查 #

• 先清除Xcode历史构建缓存：关闭Xcode后在终端执行命令 rm -rf ~/Library/Developer/Xcode/DerivedData，重启Xcode后重新触发预览
• 临时移除项目中自定义的DEBUG模式编译Flags、预处理宏配置，部分仅针对运行场景配置的参数不会自动适配预览构建流程，移除后如果预览恢复正常，可以逐一验证定位冲突配置
• 在项目中新建空白SwiftUI文件，仅写最简单的静态Text预览，排除单个文件的语法兼容问题：如果空白文件可以正常预览，说明问题出在原有业务代码的语法/依赖引用上；如果空白文件也无法预览，说明是项目全局配置问题。

3. 架构与依赖适配检查 #

• 打开项目Build Settings，检查Architectures配置项，是否存在限制本地架构的配置：SwiftUI预览会基于当前Mac的架构（Intel为x86_64，Apple Silicon为arm64）构建，部分为了真机/模拟器运行限制了架构的配置会导致预览构建失败
• 如果项目使用了包管理工具引入第三方依赖，将依赖升级到适配Xcode 13的最新版本，部分旧版本依赖没有适配预览的专属构建规则，仅会在预览编译阶段触发报错。

补充说明：正常真机/模拟器运行和SwiftUI预览的编译链路存在差异，预览会额外执行代码插桩、局部编译校验等专属步骤，很多常规编译不会触发的边缘问题只会在预览阶段暴露，因此不要用常规运行正常来排除编译相关的配置问题。

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