NSTableCellView行在不同Mac设备上对齐不一致问题排查

我之前做macOS项目时碰到过完全一模一样的情况——Storyboard里布局显示正常，一台MBP上运行时行对齐完美，换另一台MBP或者iMac就出现单元格垂直压缩、错位的问题，而且所有设备都是最新版Xcode和操作系统，Storyboard约束也完全一致。折腾了好几天才找到根源，给你分享几个关键的排查方向：

• 确认单元格高度的自动计算逻辑
  这种跨设备错位最常见的原因就是NSTableView的行高计算出了问题。如果你用了automaticRowHeight，一定要确保你的NSTableCellView内部有完整的垂直约束链：从单元格的顶部锚点，到最上方控件的顶部，再依次连接所有控件的上下间距，最后到单元格的底部锚点，不能有任何缺失，否则自动布局在不同设备上可能会算出不同的高度。你也可以先手动设置一个固定行高测试，如果固定行高没问题，那肯定是自动计算的逻辑有问题。

• 检查设备的字体缩放/系统字体设置
  有时候用户会手动调整系统字体大小或缩放比例，哪怕都是最新系统也可能有差异。打开两台设备的「系统偏好设置->辅助功能->显示」，确认“字体大小”和“缩放”选项完全一致。另外，在Storyboard里确保所有控件用的是系统动态字体（比如选择System Font而不是固定像素的字体），避免不同设备上字体渲染高度不同导致布局错位。

• 彻底清理Xcode缓存和编译产物
  Storyboard的编译缓存偶尔会抽风，尤其是跨设备调试的时候。试试这些操作：

  • 用快捷键Cmd+Shift+K清理项目缓存，再用Cmd+Option+Shift+K做彻底清理
  • 找到DerivedData文件夹（通过Xcode的「Preferences->Locations」可以看到路径），手动删除整个文件夹
  • 重启Xcode和测试设备，重新编译运行

• 排查隐藏的约束冲突或优先级问题
  虽然你说Storyboard约束一致，但有些约束冲突在不同设备上的表现可能不一样。选中你的NSTableCellView，点击Xcode右下角的「Resolve Auto Layout Issues」，选择「Check for Issues」，看看有没有隐藏的约束警告或冲突。另外，检查所有约束的优先级，确保没有多个高优先级约束互相冲突，导致自动布局在不同设备上选择不同的妥协方案。

• 检查单元格复用的状态重置逻辑
  如果你的NSTableView开启了单元格复用，一定要在tableView(_:viewFor:row:)方法里，每次复用单元格时都重置控件的状态：比如label的numberOfLines是否正确设置，文本内容是否会动态变化导致高度改变，有没有控件的高度在复用后没有被正确更新。我之前就是因为某个label在复用后没有重置preferredMaxLayoutWidth，导致布局异常。

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