Swift iOS屏幕旋转时如何调整UICollectionView布局尺寸

失效的核心原因共3点：

• 朝向判断时机错误：layoutSubviews调用初期UIScreen.main.bounds尚未完成旋转更新，拿到的宽高是旋转前的旧值
• 布局刷新顺序错误：修改itemSize后未正确触发布局失效，提前调用layoutIfNeeded()会强制渲染旧布局属性
• 代理方法优先级冲突：如果实现了UICollectionViewDelegateFlowLayout的尺寸返回方法，直接修改layout.itemSize的设置会被代理返回值完全覆盖

正确实现步骤 #

1. 修正layoutSubviews内的布局逻辑 #

不要依赖UIScreen尺寸判断朝向，直接取当前视图自身的bounds判断（同时适配iPad分屏、侧拉等非全屏场景），修改尺寸后再触发布局失效：

open override func layoutSubviews() {
    super.layoutSubviews()

    // 用当前视图自身宽高判断竖屏/横屏状态
    let isPortrait = bounds.width < bounds.height
    let targetItemSize: CGSize = isPortrait ? CGSize(width: 50, height: 50) : CGSize(width: 100, height: 100)

    // 尺寸无变化时直接返回，避免重复触发布局刷新
    guard collectionLayout.itemSize != targetItemSize else { return }
    collectionLayout.itemSize = targetItemSize

    // 修改属性后再调用布局失效，不要注释这行，也不要在这之前调用layoutIfNeeded
    collectionLayout.invalidateLayout()
}

2. 检查FlowLayout代理实现 #

如果你为collectionView设置了delegate，并且实现了以下代理方法，必须在代理方法内返回对应方向的尺寸，否则直接修改layout的itemSize不会生效：

// 实现该方法后，layout.itemSize的全局设置会被忽略，每个item的尺寸以代理返回值为准
func collectionView(_ collectionView: UICollectionView, 
                    layout collectionViewLayout: UICollectionViewLayout, 
                    sizeForItemAt indexPath: IndexPath) -> CGSize {
    let isPortrait = collectionView.bounds.width < collectionView.bounds.height
    return isPortrait ? CGSize(width: 50, height: 50) : CGSize(width: 100, height: 100)
}

如果不需要针对不同indexPath设置不同尺寸，直接删掉这个代理方法即可，全局设置itemSize就会生效。

3. 兜底添加尺寸变化监听 #

对于部分复杂布局场景，可以在自定义UIView中添加traitCollection变化回调，主动触发布局刷新：

override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
    super.traitCollectionDidChange(previousTraitCollection)
    collectionLayout.invalidateLayout()
}

注意事项 #

• 确认collectionView已经添加了正确的自动布局约束，能跟随父视图（你的自定义UIView）尺寸变化更新自身frame，如果collectionView的frame是固定值，任何布局修改都不会生效
• 不要在调用invalidateLayout()前后主动调用layoutIfNeeded()，系统会在下一个布局周期自动用新的布局属性重绘，提前调用反而会渲染旧布局

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