UICollectionView列表布局单元格高亮样式异常求助

• 确认UICollectionLayoutListConfiguration的外观设置是否正确：创建列表布局时，必须明确指定appearance: .sidebar，而非.insetGrouped、.plain等其他外观选项。需确保代码是类似let config = UICollectionLayoutListConfiguration(appearance: .sidebar)的写法，避免误用外观类型导致样式偏差。

• 检查单元格的选择与高亮属性：

  • 确认未修改UICollectionViewListCell的selectionStyle属性，保持默认的.default，若设置为.none或自定义值会覆盖系统高亮样式。
  • 排查是否有代码手动修改cell.isHighlighted状态，或在其他逻辑中强制更改单元格的高亮视觉表现。

• 排查contentConfiguration的自定义设置：

  • 检查是否为contentConfiguration设置了backgroundColor，自定义背景色会覆盖系统高亮时的默认背景效果。
  • 确认未修改contentConfiguration的文本颜色、字体等属性，部分自定义属性可能导致高亮时的视觉反差不符合系统风格。

• 检查CollectionView代理方法的干扰：

  • 确认未实现collectionView(_:shouldHighlightItemAt:)并返回false，这会直接禁用高亮效果。
  • 排查是否在collectionView(_:didHighlightItemAt:)或collectionView(_:didUnhighlightItemAt:)中添加了自定义高亮样式代码，此类代码会覆盖系统默认行为。

• 排除全局UIAppearance设置的影响：

  • 检查项目中是否通过UIAppearance为UICollectionViewCell或UICollectionViewListCell设置了全局样式（如UICollectionViewCell.appearance().backgroundColor = .white），全局样式优先级高于sidebar的默认样式。

• 验证iOS版本一致性：确保测试设备的iOS版本与教程使用的版本一致，不同iOS 14子版本可能存在细微的样式调整，版本不匹配可能导致视觉差异。

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