XIB配置错误致Unknown custom class报错及setUpLayout崩溃求助

• 清理缓存重建项目

  1. 关掉Xcode，删掉项目对应的DerivedData文件夹（路径一般是~/Library/Developer/Xcode/DerivedData/下的项目专属文件夹）
  2. 重新打开项目，按Cmd+Shift+K清理构建文件夹，或者通过Product > Clean Build Folder操作
  3. 重启Xcode后重新编译运行

• 核对XIB的File's Owner配置
  选中XIB的File's Owner，在右侧Identity Inspector面板里：

  • 确认Class字段准确填写自定义类名，Module手动选择当前项目（别用"Inherited From Target"，直接选项目名试试）
  • 检查Target Membership是否勾选了当前项目的target

• 修正自定义类的初始化逻辑
  确保File's Owner对应的自定义类把setUpLayout移到awakeFromNib里调用，别在init?(coder:)里直接调用——因为此时XIB里的控件还没加载完成，容易崩溃。示例代码：

  init?(coder: NSCoder) {
      super.init(coder: coder)
      // 这里不要调用setUpLayout
  }
  
  override func awakeFromNib() {
      super.awakeFromNib()
      setUpLayout() // 在这里调用布局方法才安全
  }
  

• 检查XIB源码残留引用
  右键XIB文件选择Open As > Source Code，搜索你的自定义类名，确认只有File's Owner对应的<object>标签里有这个类名，View对应的标签类是UIView。如果有多余的自定义类引用，直接删掉后保存，再重新打开XIB。

• 确认自定义类文件的配置
  打开自定义类的.swift文件：

  • 检查Target Membership是否勾选了正确的target
  • 类定义不要用private修饰，否则XIB无法识别这个类

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