Xcode 12.4下IB中viewController显示黑屏的异常排查与解决

触发场景与异常表现 #

• 基础环境：Xcode 升级至 12.4（Build 12D4e）版本，搭配 macOS 10.15.7 系统打开历史存量 iOS 项目时，出现预览故障
• 异常界面参考：
  
• 具体故障特征：
  • IB 内的 ViewController 预览完全失常：所有控件丢失标签文本内容、视图背景显示纯黑色、附带蓝色边框
  • 即便在 IB 中手动新增原生控件，也会触发完全一致的显示异常
• 异常影响边界：项目在 Simulator、真机上运行时所有功能与显示均正常，仅 IB 预览环节存在故障
• 已尝试无效的常规操作：清理构建文件夹、重启 Xcode、重启 macOS 系统，均无法解决该预览问题

验证有效的修复路径 #

• 可直接落地的操作：将项目回退至上一次提交的版本后，预览异常完全消失
• 故障诱因推断：上次提交中曾使用带有 @IBDesignable 属性的自定义类，在提交代码至远程仓库前删除该自定义类的操作，叠加 Xcode 版本升级的变更触发了版本兼容异常
• 同类场景处理参考：对照 Stack Overflow 社区同类问题的通用排查思路，回退关联的变更版本后，所有 IB 预览功能即可恢复正常

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