UICollectionView两列布局失效，如何始终保持两列并禁用自动调整？

你的问题很典型——手动计算单元格宽度时容易忽略布局的间距参数，或者单元格内部的约束导致尺寸“跑飞”。下面给你几个可靠的解决方案：

方法一：正确配置UICollectionViewFlowLayout并修正宽度计算 #

你当前的代码只考虑了collectionView的宽度和固定padding，但没结合UICollectionViewFlowLayout的间距属性，这会导致实际布局时单元格宽度出现偏差。

步骤1：初始化FlowLayout时配置基础属性 #

在viewDidLoad里统一设置布局的间距和内边距：

override func viewDidLoad() {
    super.viewDidLoad()
    
    let flowLayout = UICollectionViewFlowLayout()
    // 列之间的间距
    flowLayout.minimumInteritemSpacing = 10
    // 行之间的间距
    flowLayout.minimumLineSpacing = 10
    // 整个section的内边距（上下左右）
    flowLayout.sectionInset = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10)
    
    collectionView.collectionViewLayout = flowLayout
    collectionView.delegate = self
    collectionView.dataSource = self
}

步骤2：修正sizeForItemAt的宽度计算逻辑 #

把内边距和列间距都纳入计算，确保两列宽度完全一致：

func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
    guard let flowLayout = collectionViewLayout as? UICollectionViewFlowLayout else {
        return CGSize(width: 0, height: 400)
    }
    
    // 总占用宽度 = 左右内边距 + 列之间的间距（两列仅1个间距）
    let totalHorizontalSpace = flowLayout.sectionInset.left + flowLayout.sectionInset.right + flowLayout.minimumInteritemSpacing
    let itemWidth = (collectionView.bounds.width - totalHorizontalSpace) / 2
    
    return CGSize(width: itemWidth, height: 400)
}

步骤3：处理屏幕尺寸变化 #

当collectionView宽度改变（比如屏幕旋转）时，需要强制刷新布局：

override func viewWillLayoutSubviews() {
    super.viewWillLayoutSubviews()
    collectionView.collectionViewLayout.invalidateLayout()
}

方法二：修复单元格内部UIStackView的约束 #

如果单元格内部的StackView约束没设置好，会导致单元格被内部控件撑开，忽略你设置的宽度。确保StackView和单元格contentView完全贴合：

在自定义单元格的初始化方法或awakeFromNib中添加约束：

class CustomCell: UICollectionViewCell {
    let stackView = UIStackView()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupStackView()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupStackView()
    }
    
    private func setupStackView() {
        stackView.translatesAutoresizingMaskIntoConstraints = false
        // 根据你的需求设置StackView方向（vertical/horizontal）
        stackView.axis = .vertical
        // 让内部控件填满StackView宽度
        stackView.alignment = .fill
        stackView.distribution = .fill
        
        contentView.addSubview(stackView)
        
        NSLayoutConstraint.activate([
            stackView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            stackView.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            stackView.topAnchor.constraint(equalTo: contentView.topAnchor),
            stackView.bottomAnchor.constraint(equalTo: contentView.bottomAnchor)
        ])
        
        // 添加你的Label和Image到stackView
        // stackView.addArrangedSubview(yourLabel)
        // stackView.addArrangedSubview(yourImageView)
    }
}

同时注意内部控件的约束：比如给Label设置numberOfLines和lineBreakMode，给ImageView设置contentMode = .scaleAspectFit并添加合适的尺寸约束，避免超出StackView宽度。

方法三：使用UICollectionViewCompositionalLayout（iOS 13+） #

如果你支持iOS 13及以上版本，CompositionalLayout是更省心的选择，不需要手动计算宽度，系统会自动适配两列布局：

override func viewDidLoad() {
    super.viewDidLoad()
    
    let layout = UICollectionViewCompositionalLayout { (sectionIndex, layoutEnvironment) -> NSCollectionLayoutSection? in
        // 每个item占group宽度的1/2，高度固定400
        let itemSize = NSCollectionLayoutSize(
            widthDimension: .fractionalWidth(0.5),
            heightDimension: .absolute(400)
        )
        let item = NSCollectionLayoutItem(layoutSize: itemSize)
        // item左右各留5pt内边距，凑成10pt的列间距
        item.contentInsets = NSDirectionalEdgeInsets(top: 0, leading: 5, bottom: 10, trailing: 5)
        
        // group水平排列，包含两个item，宽度占满collectionView
        let groupSize = NSCollectionLayoutSize(
            widthDimension: .fractionalWidth(1.0),
            heightDimension: .absolute(400)
        )
        let group = NSCollectionLayoutGroup.horizontal(layoutSize: groupSize, subitems: [item])
        
        let section = NSCollectionLayoutSection(group: group)
        // 设置section的内边距
        section.contentInsets = NSDirectionalEdgeInsets(top: 10, leading: 10, bottom: 10, trailing: 10)
        
        return section
    }
    
    collectionView.collectionViewLayout = layout
    collectionView.delegate = self
    collectionView.dataSource = self
}

这种方式不需要实现sizeForItemAt，系统会自动适配不同屏幕尺寸，彻底避免手动计算的误差。

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