Swift 5：如何让UICollectionView顶部UIView不随滚动且显示在上层？

直接给UICollectionView加subview会跟着滚动，用bringSubviewToFront又盖不住contentView，核心原因是UICollectionView的contentView是负责滚动的容器，默认层级在所有自定义subview之上。要在自定义UICollectionView类里实现固定顶部阴影，按以下步骤来：

自定义UICollectionView实现代码 #

class CustomCollectionView: UICollectionView {
    // 初始化顶部渐变阴影视图
    private let topCurtainView: UIView = {
        let view = UIView()
        let gradientLayer = CAGradientLayer()
        // 调整渐变颜色、透明度适配需求
        gradientLayer.colors = [UIColor.clear.cgColor, UIColor.black.withAlphaComponent(0.25).cgColor]
        gradientLayer.startPoint = CGPoint(x: 0.5, y: 0)
        gradientLayer.endPoint = CGPoint(x: 0.5, y: 1)
        view.layer.insertSublayer(gradientLayer, at: 0)
        return view
    }()
    
    override init(frame: CGRect, collectionViewLayout layout: UICollectionViewLayout) {
        super.init(frame: frame, layout: layout)
        setupTopShadow()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupTopShadow()
    }
    
    private func setupTopShadow() {
        addSubview(topCurtainView)
        topCurtainView.translatesAutoresizingMaskIntoConstraints = false
        
        // 固定阴影在collectionView顶部，高度按需调整
        NSLayoutConstraint.activate([
            topCurtainView.topAnchor.constraint(equalTo: topAnchor),
            topCurtainView.leadingAnchor.constraint(equalTo: leadingAnchor),
            topCurtainView.trailingAnchor.constraint(equalTo: trailingAnchor),
            topCurtainView.heightAnchor.constraint(equalToConstant: 50)
        ])
        
        // 关键操作：把滚动用的contentView移到阴影视图下层，确保阴影始终显示在最上方
        sendSubviewToBack(contentView)
    }
    
    override func layoutSubviews() {
        super.layoutSubviews()
        // 布局更新时同步渐变层的frame，避免错位
        topCurtainView.layer.sublayers?.first?.frame = topCurtainView.bounds
    }
}

关键逻辑说明 #

1. 固定阴影位置：通过AutoLayout把阴影视图绑定在UICollectionView的顶部边缘，不会随contentView滚动而移动
2. 调整层级：调用sendSubviewToBack(contentView)将滚动容器移到阴影下层，解决bringSubviewToFront无效的问题
3. 适配布局变化：在layoutSubviews中更新渐变层的frame，保证旋转、屏幕尺寸变化时渐变效果正常

额外适配提示 #

• 如果你的UICollectionView设置了contentInset，需要调整阴影的top约束，比如：

  topCurtainView.topAnchor.constraint(equalTo: topAnchor, constant: -contentInset.top)
  

• 渐变的颜色、起始点、高度都可以根据产品需求修改

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