如何通过UIButton.Configuration调整按钮图片尺寸匹配按钮大小？

问题原因 #

当你使用Assets里的individual scales图片时，加载后的UIImage会保留基于1x尺寸的固有大小（也就是你设置的45x45），UIButton的默认配置会尊重这个固有尺寸，不会自动拉伸图片填满按钮；而single scale的图片没有scale标记，系统会直接按按钮尺寸拉伸显示，所以看起来正常。

解决方案 #

通过修改UIButton.Configuration的两个核心属性，就能让图片填满按钮：

1. imageContentMode: 设置图片的拉伸模式为.scaleToFill，强制图片填满分配的空间
2. imagePlacement: 当按钮没有文字时，设置为.fill，确保图片占据整个按钮区域

修改后的代码如下：

func buttonImage() {
    var configuration = UIButton.Configuration.plain()
    // 加载图片
    let image = UIImage(named: "someImage")!
    configuration.image = image
    configuration.baseBackgroundColor = .red
    configuration.contentInsets = .zero
    
    // 关键配置：让图片填满按钮
    configuration.imageContentMode = .scaleToFill
    configuration.imagePlacement = .fill
    
    let button = UIButton(configuration: configuration)
    button.backgroundColor = .red
    button.translatesAutoresizingMaskIntoConstraints = false
    
    view.addSubview(button)
    
    NSLayoutConstraint.activate([
        button.widthAnchor.constraint(equalToConstant: 300),
        button.heightAnchor.constraint(equalToConstant: 300),
        button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
        button.centerYAnchor.constraint(equalTo: view.centerYAnchor)
    ])
}

补充说明 #

• 如果你想保持图片比例同时填满按钮（避免变形），可以把imageContentMode改成.scaleAspectFill，然后给按钮加上button.clipsToBounds = true，这样图片会按比例放大并裁剪超出部分。
• 已经设置的contentInsets = .zero要保留，避免图片和按钮边缘出现空隙。

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