UICollectionView单元格内按钮图片无法正常缩放适配问题

你的代码和配置里存在4个直接导致问题的错误：

• 代码末尾设置的cell.contentMode = .redraw、appButton.contentMode = .redraw直接覆盖了之前配置的缩放模式，.redraw只会调用视图的setNeedsDisplay按原内容重绘，不会做任何缩放适配。
• 给cell、UIButton本身设置contentMode对图片缩放无效：cell的contentMode不会影响内部子视图，UIButton的图片由其内部imageView子控件承载，必须直接设置imageView的contentMode才会生效。
• 仅在属性检查器中设置Cell为Custom尺寸不代表实际运行时cell尺寸就是250×250，若没有正确配置FlowLayout的itemSize，cell会使用默认尺寸渲染。
• 若MyButton没有添加相对cell contentView的正确约束/匹配frame，按钮实际尺寸会和预期不符，图片自然无法按预期缩放。

分步修复操作 #

1. 修正cellForItemAt代理方法代码 #

删除冲突的冗余配置，直接给按钮内部的imageView设置正确的缩放模式，修正后代码如下：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "cell", for: indexPath) as! MyCollectionCell
    let appButton = cell.MyButton!
    
    cell.clipsToBounds = true
    appButton.setTitle("", for: .normal)
    appButton.setImage(UIImage(named: webSeriesImage[indexPath.row]), for: .normal)
    // 直接设置按钮内部imageView的缩放模式，需要完整展示图片不裁剪用.scaleAspectFit，需要铺满裁剪用.scaleAspectFill
    appButton.imageView?.contentMode = .scaleAspectFit
    appButton.clipsToBounds = true
    appButton.tag = indexPath.row
    appButton.addTarget(self, action: #selector(didTap(_:)), for: .touchUpInside)
    collectionView.backgroundColor = .clear
    
    // 必须删除原来末尾两行错误的.redraw配置
    return cell
}

2. 强制确认cell尺寸为250×250 #

不要仅依赖属性检查器的Custom配置，实现UICollectionViewDelegateFlowLayout的代理方法，固定cell尺寸：

// 遵守UICollectionViewDelegateFlowLayout协议后实现该方法
func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
    return CGSize(width: 250, height: 250)
}

如果是代码初始化FlowLayout，也可以直接给layout设置固定itemSize：

let flowLayout = UICollectionViewFlowLayout()
flowLayout.itemSize = CGSize(width: 250, height: 250)
// 按需配置滚动方向、行间距、组间距即可

3. 检查按钮布局约束 #

如果是用XIB/Storyboard拖入的MyButton，确认给按钮添加了相对cell的contentView居中、宽高匹配的约束，无约束警告；如果是代码创建的按钮，在cell的layoutSubviews方法里给按钮设置和contentView匹配的frame，确保按钮实际尺寸和cell一致。

4. 异常排查 #

如果以上配置完成后仍有问题，可以在cellForItemAt方法中打印实际尺寸校验布局是否正确：

print("cell实际尺寸：\(cell.bounds.size)")
print("按钮实际尺寸：\(appButton.bounds.size)")
print("按钮图片视图实际尺寸：\(appButton.imageView?.bounds.size ?? .zero)")

如果打印出的尺寸和250×250不符，优先排查约束/FlowLayout配置问题，和图片缩放逻辑无关。

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