水平UIStackView内UIView设置圆角失效的解决方法

圆角不生效的核心原因是生成mask路径时拿到的视图bounds不是最终布局完成的尺寸。UIStackView是基于自动布局的特殊容器视图，它不会直接渲染自身内容，而是在多轮布局周期中动态调整子视图的frame，如果你在布局未完成时调用基于bounds绘制的圆角方法，生成的mask路径尺寸和实际显示尺寸不匹配，自然无法得到预期效果。

按以下顺序逐一验证即可定位问题：

• 在roundCorners方法内部打印当前视图的bounds.size，对比视图最终显示的实际尺寸，90%以上的场景这里拿到的是xib初始尺寸、上一轮布局的临时尺寸，甚至是宽高为0的初始值，直接导致圆角半径计算错误、路径位置偏移。
• 检查roundCorners的调用位置：如果写在UIStackView本身的layoutSubviews、或者控制器的viewDidLoad/viewWillAppear中，调用时机一定早于子视图最终frame确定的时间点。
• 检查圆角设置完成后，是否存在修改StackView间距/分布属性、更新子视图约束、触发视图动画等操作，这类操作会触发布局更新，但不会自动重绘你之前生成的静态mask。
• 检查视图层级：确认需要加圆角的视图没有被父视图的clipsToBounds属性裁剪掉边缘，也没有其他子视图覆盖在圆角位置。

根据项目支持的系统版本选对应方案即可：

方案1：兼容所有iOS版本，修正调用时机 #

把圆角方法的调用移到需要加圆角的子视图内部的layoutSubviews中，必须先调用super.layoutSubviews()拿到当前布局周期的最终bounds再生成mask，同时优化原有方法避免重复创建layer、解决Retina屏锯齿问题：

// 需要加圆角的自定义UIView子类内部
override func layoutSubviews() {
    super.layoutSubviews()
    roundCorners(corners: [.topLeft, .bottomLeft], radius: .small) // 替换为实际需要的圆角参数
}

// 优化后的圆角方法
func roundCorners(corners: UIRectCorner, radius: CurveRadius) {
    let r: CGFloat
    switch radius {
    case .small:
        r = bounds.width / 30
    case .medium:
        r = bounds.width / 25
    }
    let path = UIBezierPath(
        roundedRect: bounds,
        byRoundingCorners: corners,
        cornerRadii: CGSize(width: r, height: r)
    )
    // 复用已有maskLayer，避免重复创建
    if let mask = layer.mask as? CAShapeLayer {
        mask.path = path.cgPath
    } else {
        let mask = CAShapeLayer()
        mask.contentsScale = UIScreen.main.scale // 适配Retina屏幕，避免锯齿
        mask.path = path.cgPath
        layer.mask = mask
    }
}

方案2：iOS 11+ 推荐用系统原生圆角API #

系统原生支持的独立圆角设置会自动跟随视图布局变化，不需要每次重绘mask，性能和稳定性都更高：

// 视图初始化时调用一次即可
func commonInit() {
    layer.masksToBounds = true
    // 对应需要的圆角位置：topLeft对应layerMinXMinYCorner，bottomRight对应layerMaxXMaxYCorner，按需组合
    layer.maskedCorners = [.layerMinXMinYCorner, .layerMinXMaxYCorner]
}

override init(frame: CGRect) {
    super.init(frame: frame)
    commonInit()
}

required init?(coder: NSCoder) {
    super.init(coder: coder)
    commonInit()
}

// 如果需要动态根据宽度计算圆角半径，仅需在layoutSubviews中更新cornerRadius即可
override func layoutSubviews() {
    super.layoutSubviews()
    layer.cornerRadius = bounds.width / 25 // 对应medium半径，small则除以30
}

• 不要在awakeFromNib、viewDidLoad这类布局未完成的生命周期中调用基于frame/bounds计算的圆角方法。
• 如果UIStackView使用了fillEqually、fillProportionally分布模式，子视图的最终frame会在StackView完成自身布局后才确定，必须等布局落地后再生成mask。
• 不要直接给UIStackView本身加自定义mask，StackView的渲染逻辑和普通UIView不同，mask会被其内部布局逻辑覆盖。

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