UICollectionViewCompositionalLayout动态高度引发布局调整与闪烁求助

针对你遇到的三个问题，给出对应的解决方案： #

问题1：同时为item和group设置estimated height导致滚入时集合视图调整高度

不要同时给垂直滚动层级的item和group设置estimated size，仅在垂直section的group上设置estimated height，垂直item的size直接设为.fractionalHeight(1.0).fractionalWidth(1.0)。双重estimated配置会让布局系统在计算时出现冲突，导致单元格滚入视图时重新计算高度，引发视图跳动。

正确的垂直布局配置示例：

// 垂直section的group
let verticalGroup = NSCollectionLayoutGroup.vertical(
    layoutSize: NSCollectionLayoutSize(
        widthDimension: .fractionalWidth(1.0),
        heightDimension: .estimated(200) // 仅此处设置预估高度
    ),
    subitems: [verticalItem]
)

// 垂直item（承载水平滚动列表）
let verticalItem = NSCollectionLayoutItem(
    layoutSize: NSCollectionLayoutSize(
        widthDimension: .fractionalWidth(1.0),
        heightDimension: .fractionalHeight(1.0) // 占满group高度
    )
)
// 为item设置正交滚动布局
verticalItem.contentInsets = NSDirectionalEdgeInsets(top: 8, leading: 8, bottom: 8, trailing: 8)
let orthogonalLayout = NSCollectionLayoutSection(group: horizontalGroup)
orthogonalLayout.orthogonalScrollingBehavior = .continuous
verticalItem.contentLayoutGuide = orthogonalLayout

问题2：group设estimated height、item设1.0 fractional height时高度被当作绝对值

这是因为正交滚动的子布局未正确配置高度计算逻辑，需确保：

1. 正交滚动的group必须设置.estimated(height: ...)，而非固定高度，让其高度由内部item的内容决定：

// 水平滚动的group
let horizontalGroup = NSCollectionLayoutGroup.horizontal(
    layoutSize: NSCollectionLayoutSize(
        widthDimension: .absolute(150), // 水平item宽度固定
        heightDimension: .estimated(200) // 此处必须设预估高度
    ),
    subitems: [horizontalItem]
)

// 水平item
let horizontalItem = NSCollectionLayoutItem(
    layoutSize: NSCollectionLayoutSize(
        widthDimension: .fractionalWidth(1.0),
        heightDimension: .fractionalHeight(1.0) // 占满group高度
    )
)

2. 承载水平滚动列表的垂直cell中，需将水平UICollectionView的top/bottom/leading/trailing完全约束到cell的contentView，且垂直方向的抗压缩优先级保持为required，确保cell高度跟随水平列表的内容高度。

问题3：子类化布局重写layoutAttributesForElementsInRect引发滚动闪烁

子类化布局修改属性会触发额外的布局更新，导致滚动时重绘闪烁，建议通过cell自身调整布局属性替代：

1. 在垂直cell中重写preferredLayoutAttributesFitting(_:)方法，根据水平列表的contentSize动态调整cell高度：

class VerticalCell: UICollectionViewCell {
    let horizontalCollectionView = UICollectionView(...)
    
    override func preferredLayoutAttributesFitting(_ layoutAttributes: UICollectionViewLayoutAttributes) -> UICollectionViewLayoutAttributes {
        let attributes = super.preferredLayoutAttributesFitting(layoutAttributes)
        // 根据水平列表的内容高度更新cell高度
        let contentHeight = horizontalCollectionView.contentSize.height
        if contentHeight > attributes.size.height {
            attributes.size.height = contentHeight
        }
        return attributes
    }
    
    // 监听水平列表contentSize变化，通知主列表更新布局
    override func didMoveToSuperview() {
        super.didMoveToSuperview()
        horizontalCollectionView.addObserver(self, forKeyPath: "contentSize", options: .new, context: nil)
    }
    
    override func willMoveToSuperview(_ newSuperview: UIView?) {
        super.willMoveToSuperview(newSuperview)
        if newSuperview == nil {
            horizontalCollectionView.removeObserver(self, forKeyPath: "contentSize")
        }
    }
    
    override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
        guard keyPath == "contentSize", let collectionView = object as? UICollectionView else {
            super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
            return
        }
        // 通知主列表更新当前cell布局
        superview?.superview.flatMap { $0 as? UICollectionView }?.performBatchUpdates(nil, completion: nil)
    }
}

2. 确保主UICollectionView的estimatedItemSize设置为.automatic，让布局系统能正确处理动态高度的单元格：

mainCollectionView.estimatedItemSize = UICollectionViewFlowLayout.automaticSize

额外注意事项 #

• 所有单元格的内部约束必须完整，确保Auto Layout能正确计算内容高度；
• 预估高度的数值尽量接近实际内容高度，减少布局调整的幅度；
• 避免在滚动过程中频繁触发布局更新，可通过防抖处理优化性能。

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