Swift问题：调用addSubview后overlayView未出现在视图层级中

• 先确认addOverlayView()是否被实际调用
  你可以在方法第一行加个断点，或者插入print("addOverlayView 已执行")，运行后看控制台有没有输出。如果没触发这个方法，那视图自然不会被创建——比如可能是cell生命周期里没调用该方法，或者cell复用时没重新触发。

• 检查imageView是否为nil
  因为imageView是IBOutlet，很可能存在storyboard/xib关联失败的情况。在addOverlayView()里加一行print(imageView)，如果输出是nil，说明这个IBOutlet没正确连接，根本没法往它上面加子视图。

• 验证overlayView的frame是否合理
  你用overlayView.frame = self.bounds来设置尺寸，但要注意：如果调用方法时cell还没完成布局（比如在cellForItemAt里直接调用，此时cell的frame还没被collectionView确定），self.bounds可能是CGRectZero，导致视图虽然被添加，但尺寸为0，在视图层级里几乎找不到。
  更稳妥的方式是用Auto Layout约束：

  overlayView.translatesAutoresizingMaskIntoConstraints = false
  NSLayoutConstraint.activate([
      overlayView.topAnchor.constraint(equalTo: imageView.topAnchor),
      overlayView.leadingAnchor.constraint(equalTo: imageView.leadingAnchor),
      overlayView.trailingAnchor.constraint(equalTo: imageView.trailingAnchor),
      overlayView.bottomAnchor.constraint(equalTo: imageView.bottomAnchor)
  ])
  

  这样不管imageView尺寸怎么变化，overlayView都会铺满它。

• 修正bringSubview(toFront:)的调用对象
  你现在调用的是self.bringSubview(toFront: overlayView)，但overlayView是imageView的子视图，不是BrowseCell的子视图。正确的写法是imageView.bringSubview(toFront: overlayView)——这一步不影响视图层级的存在，但会影响显示优先级，修正后更严谨。

• 调整视图层级捕获的时机
  你在函数末尾设了断点，但此时视图可能还没完成渲染。可以在断点处手动调用self.layoutIfNeeded()，之后再用Capture View Hierarchy检查，看看能不能找到overlayView。

• 避免重复添加视图（辅助排查）
  如果cell被复用，多次调用addOverlayView()会生成多个重复视图。可以给overlayView加个tag，添加前先检查：

  if imageView.viewWithTag(1001) == nil {
      let overlayView = UIView()
      overlayView.tag = 1001
      // 其他配置代码...
      imageView.addSubview(overlayView)
  }
  

  这样既能避免重复添加，也能验证之前的添加操作是否被覆盖。

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