UIButton子ImageView不遵循scaleAspectFit内容模式问题如何解决

问题核心原因 #

iOS 15及以上版本引入了UIButton.Configuration相关API，Xcode13新建的UIButton默认启用新式配置，旧版的contentVerticalAlignment、contentHorizontalAlignment以及直接修改imageView属性的很多逻辑会被配置项覆盖，这是你之前查阅的旧方案失效的核心原因。

可行解决方案 #

方案1：使用新式UIButton.Configuration适配（推荐，适配iOS15+） #

在viewDidLoad里添加如下配置即可：

// 先获取当前按钮配置，无配置则新建
var config = button.configuration ?? UIButton.Configuration.plain()
// 设置图片缩放模式为适配按钮尺寸
config.imageScaling = .scaleFit
// 可选：需要调整图片内边距可加下行代码
config.contentInsets = .zero
// 将配置回写至按钮
button.configuration = config

不需要额外修改imageView的contentMode，该配置优先级更高，会自动完成适配。

方案2：禁用新式配置，回退到旧版UIButton行为（兼容iOS15以下版本） #

如果需要兼容更低iOS版本，可以在Interface Builder里修改UIButton的配置：

• 打开IB的按钮属性面板，找到Style选项，把默认的Plain改为Default
• 保留原有代码里的button.imageView?.contentMode = .scaleAspectFit设置即可正常生效

方案3：完全自定义子ImageView（灵活度最高） #

如果上述方案都不满足需求，可以直接给UIButton添加自定义的UIImageView子控件，手动加约束固定在按钮内部，完全自主控制缩放逻辑：

let customImageView = UIImageView(image: UIImage(named: "你的图片名称"))
customImageView.contentMode = .scaleAspectFit
customImageView.translatesAutoresizingMaskIntoConstraints = false
button.addSubview(customImageView)
NSLayoutConstraint.activate([
    customImageView.widthAnchor.constraint(equalTo: button.widthAnchor),
    customImageView.heightAnchor.constraint(equalTo: button.heightAnchor),
    customImageView.centerXAnchor.constraint(equalTo: button.centerXAnchor),
    customImageView.centerYAnchor.constraint(equalTo: button.centerYAnchor)
])

该方式完全不受UIButton内置逻辑的影响，适配所有iOS版本。

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