Swift自定义View类后视图不显示问题咨询

嘿，我太懂这种郁闷了——明明单独写的视图好好的，一封装成自定义类/结构体就凭空消失！大概率是这几个常见问题，咱们一步步排查：

先看你用的是UIKit还是SwiftUI？ #

1. UIKit 场景下的高频坑 #

• 忘记给视图设置尺寸/约束
  纯代码写UIKit自定义View时，默认frame是CGRect.zero，如果没手动设置frame，也没添加足够的Auto Layout约束，视图就会因为没有宽高而“隐身”。另外，用Auto Layout时别忘了把子视图的translatesAutoresizingMaskIntoConstraints设为false，否则约束不生效。
• 初始化方法没写全
  自定义UIView必须覆盖init(frame:)和init?(coder:)两个初始化方法（如果要支持Storyboard/XIB的话）。要是只写了其中一个，在某些初始化场景下（比如直接let card = CardView()），视图内部的子控件根本不会被创建。
• 子视图没加到自身上
  封装时很容易犯的低级错误：写了创建子视图的代码，却漏了self.addSubview(subview)，那子视图自然不会显示在界面上。

举个错误示范和修正版：

错误写法：

class CardView: UIView {
    // 只写了coder初始化，漏了frame初始化
    override init?(coder: NSCoder) {
        super.init(coder: coder)
        setupUI()
    }

    private func setupUI() {
        let titleLabel = UILabel()
        titleLabel.text = "我的卡片"
        titleLabel.frame = CGRect(x: 16, y: 16, width: 200, height: 24)
        // 漏了关键的 addSubview！
    }
}

修正后：

class CardView: UIView {
    // 覆盖两个初始化方法
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupUI()
    }

    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupUI()
    }

    private func setupUI() {
        self.backgroundColor = .white
        let titleLabel = UILabel()
        titleLabel.text = "我的卡片"
        titleLabel.frame = CGRect(x: 16, y: 16, width: 200, height: 24)
        // 一定要添加到当前视图
        self.addSubview(titleLabel)
    }
}

2. SwiftUI 场景下的常见问题 #

• 自定义View的body返回了空内容
  比如不小心写了body: some View { EmptyView() }，或者条件判断逻辑错误，导致返回了空视图，自然看不到。
• 视图没有足够的尺寸支撑
  SwiftUI的视图默认自适应内容大小，但如果你的自定义View内部没有能撑起宽高的元素（比如只有一个无文本的Text），又没加.frame()、.fixedSize()这类尺寸修饰符，在父视图里很可能被压缩到消失。
• 初始化参数传递错误
  如果你的自定义View依赖外部传入的数据来渲染内容（比如CardView(title: String)），但初始化时传了空值或者错误的参数，会导致内部视图没被正确渲染。

举个SwiftUI的错误示例：

错误写法：

struct CardView: View {
    var body: some View {
        // 没有设置尺寸，文本又为空的话，视图会缩成一点
        Text("")
            .background(.white)
            .cornerRadius(8)
    }
}

// 使用时
struct ContentView: View {
    var body: some View {
        CardView()
            // 父视图没给约束，CardView没有尺寸支撑
    }
}

修正后：

struct CardView: View {
    var title: String

    var body: some View {
        Text(title)
            .padding()
            .background(.white)
            .cornerRadius(8)
            .frame(width: 300, height: 100) // 给固定尺寸或者让padding撑起大小
    }
}

// 使用时
struct ContentView: View {
    var body: some View {
        CardView(title: "我的卡片")
    }
}

快速排查小技巧 #

• 给自定义View加个显眼的背景色（比如UIKit里self.backgroundColor = .red，SwiftUI里.background(.red)），这样能快速判断是视图本身没显示，还是内部内容没渲染。
• 用Debug View Hierarchy（Xcode里的调试视图层级）查看：UIKit可以直接看视图树，SwiftUI可以用Xcode的预览调试，看看你的自定义View是不是存在、有没有尺寸。

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