UILabel在UICollectionView滚动更新页码后出现缺像素问题如何解决

问题根因 #

该问题是iOS 14、15系统在3x比例的小屏设备（iPhone 12/13 mini）上的常见渲染异常：UILabel动态更新文字时，如果自身frame的坐标或尺寸存在非整数值，图层出现半像素偏移，就会触发文字边缘裁切、缺像素的问题。此前调用setNeedsLayout/layoutIfNeeded无效，是因为该异常源于图层像素对齐问题，不属于常规布局重绘的修复范围。

可行解决方案 #

• 方案1：每次更新页码后手动校准UILabel的frame到像素边界
  Objective-C示例代码：

  label.text = [NSString stringWithFormat:@"%ld", currentPage];
  CGRect frame = label.frame;
  frame.origin.x = round(frame.origin.x);
  frame.origin.y = round(frame.origin.y);
  frame.size.width = ceil(frame.size.width);
  frame.size.height = ceil(frame.size.height);
  label.frame = frame;
  

  Swift示例代码：

  label.text = "\(currentPage)"
  var frame = label.frame
  frame.origin.x = frame.origin.x.rounded()
  frame.origin.y = frame.origin.y.rounded()
  frame.size.width = frame.size.width.rounded(.up)
  frame.size.height = frame.size.height.rounded(.up)
  label.frame = frame
  

• 方案2：开启图层像素对齐配置
  给UILabel的layer添加如下配置，强制渲染时对齐当前屏幕的像素比例：

  // Objective-C
  label.layer.shouldRasterize = YES;
  label.layer.rasterizationScale = [UIScreen mainScreen].scale;
  

  // Swift
  label.layer.shouldRasterize = true
  label.layer.rasterizationScale = UIScreen.main.scale
  

• 方案3：校验布局规则
  检查UILabel的Auto Layout约束或frame设置，避免出现非整数的偏移值、尺寸值；如果使用Auto Layout，确保约束的constant参数为整数，不存在依赖父视图非对齐坐标的相对布局。
• 方案4：强制触发UILabel完整重绘
  每次更新页码前先清空text属性，再赋值新值，强制触发渲染链路的完整执行：

  label.text = nil
  label.text = "\(currentPage)"
  

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