macOS NSCollectionView自定义布局初始cell下移 拉宽窗口后恢复异常

问题现象 #

应用启动后NSCollectionView单元格出现无规律向下偏移，打印的布局计算结果正确但实际渲染不符，拉宽窗口后布局自动恢复正常，效果如下：

核心原因 #

1. 布局坐标计算错误 #

你在计算item的frame.origin时错误使用了collectionView?.frame.origin，NSCollectionViewLayout的坐标体系是相对于collectionView的内容视图，而非collectionView在父视图中的位置。初始加载时如果collectionView的frame.origin不为0，会额外叠加偏移量，导致item整体偏移。拉宽窗口触发重新布局时，collectionView的frame已经稳定，叠加的偏移刚好和预期对齐，才会显示正常。

2. 布局方法中错误触发约束更新 #

你在layoutAttributesForElements(in:)方法中调用了collectionView?.updateConstraints()，布局计算过程中主动触发约束更新会导致布局时序错乱，初始加载时item的frame会被后续的约束更新逻辑覆盖，直到窗口resize触发二次布局才会对齐。

3. Autoresizing Mask冲突 #

NSCollectionView会先应用你返回的布局属性frame，但如果item本身开启了Autoresizing，会在后续的视图布局pass中根据容器大小再次调整frame。初始加载时容器大小还未稳定，Autoresizing调整后的frame和你预期的布局结果冲突，窗口resize后容器大小稳定，Autoresizing调整结果才和布局计算值一致。

修复方案 #

1. 修正item坐标计算逻辑，删除collectionView父视图偏移叠加：

// 原错误代码
var shiftedOrigin = collectionView?.frame.origin ?? .zero
shiftedOrigin = shiftedOrigin.applying(CGAffineTransform(translationX: width * CGFloat(i), y: CGFloat(s) * height))
// 修正后代码
let shiftedOrigin = CGPoint(x: width * CGFloat(i), y: CGFloat(s) * height)

2. 删除layoutAttributesForElements(in:)方法中的collectionView?.updateConstraints()调用，该方法仅需返回布局属性，不可修改视图状态。
3. 关闭item的Autoresizing适配，避免覆盖布局返回的frame：
   • 代码设置：itemView.autoresizingMask = []
   • XIB设置：取消Autoresizing面板中所有内外边距、宽高拉伸的勾选
4. 可选优化：在prepare()方法开头判断如果collectionView的宽度为0直接返回，避免第一次加载时计算无效布局属性。

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