UICollectionView单元格间距失效求助：无间距网格布局异常

看起来你遇到的问题很典型——明明没碰布局代码，却突然出现了水平间距。结合你的代码和描述，我来分析可能的原因和对应的解决办法：

可能的原因 #

1. 布局时机错误
   你在viewDidLoad里计算collectionView.bounds，但这个阶段视图的布局还没完全完成（尤其是使用Auto Layout的场景）。此时获取的collectionView宽度可能不是最终显示的实际宽度，导致itemSize计算出现偏差，多个单元格累加后就会显现出间隙。

2. 浮点精度误差
   当屏幕宽度无法被列数整除时，CGFloat的浮点计算可能会产生微小误差。比如某些设备宽度与列数的比值是无限小数，布局系统处理这些精度问题时，就可能把误差放大成可见的单元格间隙。

3. iOS版本更新后的布局行为变化
   你提到更新了电脑，大概率同步升级了Xcode或iOS SDK。部分iOS版本对UICollectionViewFlowLayout的尺寸计算逻辑有细微调整，导致之前的静态布局代码不再完全适配新的系统行为。

解决办法 #

方法一：在正确的时机计算布局 #

把布局设置代码移到viewDidLayoutSubviews方法中，这个方法会在视图布局真正完成后触发，此时获取的collectionView边界是完全准确的：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    
    guard let layout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout else { return }
    
    let collectionWidth = collectionView.bounds.width
    let itemWidth = collectionWidth / CGFloat(board.columns)
    
    layout.itemSize = CGSize(width: itemWidth, height: itemWidth)
    layout.sectionInset = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
    layout.minimumInteritemSpacing = 0
    layout.minimumLineSpacing = 0
    
    // 重新计算顶部内边距，保证居中效果
    collectionView.contentInset.top = max((collectionView.frame.height - collectionView.contentSize.height) / 5, 0)
}

方法二：使用代理方法动态返回尺寸 #

实现UICollectionViewDelegateFlowLayout协议的相关方法，让布局系统动态获取每个单元格的尺寸和间距参数，能最大程度避免静态设置的偏差：

extension ViewController: UICollectionViewDelegateFlowLayout {
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
        let itemWidth = collectionView.bounds.width / CGFloat(board.columns)
        return CGSize(width: itemWidth, height: itemWidth)
    }
    
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumInteritemSpacingForSectionAt section: Int) -> CGFloat {
        return 0
    }
    
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAt section: Int) -> CGFloat {
        return 0
    }
    
    func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAt section: Int) -> UIEdgeInsets {
        return UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
    }
}

添加这段代码后，你可以移除viewDidLoad中手动设置FlowLayout的部分，让代理方法全权负责布局参数。

方法三：强制消除浮点精度误差 #

如果确实是精度问题导致的间隙，可以对计算出的单元格宽度做取整处理，确保总宽度完全匹配collectionView的宽度：

let itemWidth = floor(collectionView.bounds.width / CGFloat(board.columns))

不过前两种方法已经能覆盖绝大多数场景，这个可以作为兜底方案。

额外检查点 #

• 打开Storyboard/XIB，检查UICollectionView的默认布局属性（比如Section Insets、Minimum Spacing）是否被意外修改——Xcode更新偶尔会重置这类可视化属性。
• 确认board.columns的数值是否正确，排查是否在其他代码逻辑中不小心修改了列数。

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