Swift中UIButton设置contentVerticalAlignment后顶部留白如何解决？

UIButton 自身的默认布局逻辑会为纯文本无图标按钮的 titleLabel 预留微小的顶部内置边距，使用 contentVerticalAlignment = .top 时该默认边距不会被自动清除。你使用极小负数 contentEdgeInsets 的写法属于 hack 了系统的布局计算逻辑，绕过了默认补白校验，不具备通用性也不建议在生产环境使用。

方案1：iOS 15+ 官方推荐 Configuration 方案（优先使用） #

iOS 15 及以上版本苹果官方推荐使用 UIButton.Configuration 管理按钮样式，可精准控制标题位置，无默认留白问题：

let button: UIButton = {
    var config = UIButton.Configuration.plain()
    config.title = "1250 km"
    config.baseForegroundColor = .black
    // 清除所有默认补白
    config.contentInsets = .zero
    // 标题右对齐
    config.titleAlignment = .trailing
    let button = UIButton(configuration: config)
    button.backgroundColor = .green
    button.translatesAutoresizingMaskIntoConstraints = false
    return button
}()

该方案是官方标准实现，没有兼容性隐患，布局逻辑完全可控。

方案2：全iOS版本兼容 调整titleEdgeInsets #

如果需要支持iOS 15以下版本，可以直接调整标题的专属内边距抵消默认顶部留白：

// 可根据实际字号调整top的负值，直到顶部无留白即可
button.titleEdgeInsets = UIEdgeInsets(top: -2, left: 0, bottom: 0, right: 0)
button.contentVerticalAlignment = .top
button.contentHorizontalAlignment = .right

写法简单，适配所有iOS版本，数值调整直观。

方案3：自定义UIButton子类 完全自定义布局 #

如果需要更精准的位置控制，不受系统默认逻辑影响，可以重写按钮的layoutSubviews方法直接设置标题位置：

class TopRightTitleButton: UIButton {
    override func layoutSubviews() {
        super.layoutSubviews()
        guard let titleLabel = titleLabel else { return }
        titleLabel.sizeToFit()
        // 直接将标题固定在右上角，如需调整间距可在此处加减对应数值
        titleLabel.frame.origin = CGPoint(
            x: bounds.maxX - titleLabel.bounds.width,
            y: bounds.minY
        )
    }
}

使用该子类替代原有的UIButton即可，不需要依赖系统的对齐属性，适合对布局精度要求高的场景。

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