iOS开发：UIView底部添加UIButton不显示及布局约束异常问题

问题原因分析 #

1. 按钮不显示的原因 #

你设置了button.translatesAutoresizingMaskIntoConstraints = false，这会让AutoLayout接管按钮的布局，同时你手动设置的frame会被系统忽略。但你没有给按钮添加任何AutoLayout约束，导致按钮没有正确的尺寸和位置参数，因此无法显示。

2. 约束报错的原因 #

激活约束时，按钮尚未被添加到myView的子视图层级中（或代码顺序错误），导致两个视图不在同一个视图层级，没有共同祖先，违反了AutoLayout的约束规则。

修复方案 #

方案一：纯Frame布局（适用于简单场景） #

如果坚持用Frame手动布局，需移除button.translatesAutoresizingMaskIntoConstraints = false（保持默认值true，让系统将frame转换为自动约束），同时基于myView的尺寸计算按钮位置：

let screenSize: CGRect = UIScreen.main.bounds
let myView = UIView(frame: CGRect(x: 0, y: 0, width: screenSize.width, height: screenSize.height))
myView.backgroundColor = .systemGray5.withAlphaComponent(0.5)
        
let button = UIButton()
// 移除translatesAutoresizingMaskIntoConstraints设置，保持默认true
button.frame = CGRect(x: 0, y: myView.frame.height - 40 - 20, width: screenSize.width, height: 40)
button.setTitle("Sleeping.. Tap here to wake up!", for: .normal)
// 增加背景色和文字色，避免与父视图背景混淆
button.backgroundColor = .white
button.setTitleColor(.black, for: .normal)
        
myView.addSubview(button)
self.view.addSubview(myView)

方案二：纯AutoLayout布局（推荐，适配全屏幕） #

AutoLayout是iOS布局的标准方式，适配不同设备屏幕，需严格遵循先添加子视图到父视图，再设置约束的顺序：

// 创建遮罩视图
let myView = UIView()
myView.backgroundColor = .systemGray5.withAlphaComponent(0.5)
myView.translatesAutoresizingMaskIntoConstraints = false
self.view.addSubview(myView)
        
// 创建按钮
let button = UIButton(type: .system)
button.setTitle("Sleeping.. Tap here to wake up!", for: .normal)
button.backgroundColor = .white
button.setTitleColor(.black, for: .normal)
button.translatesAutoresizingMaskIntoConstraints = false
myView.addSubview(button)
        
// 激活所有约束
NSLayoutConstraint.activate([
    // 遮罩视图铺满当前控制器视图
    myView.topAnchor.constraint(equalTo: self.view.topAnchor),
    myView.leadingAnchor.constraint(equalTo: self.view.leadingAnchor),
    myView.trailingAnchor.constraint(equalTo: self.view.trailingAnchor),
    myView.bottomAnchor.constraint(equalTo: self.view.bottomAnchor),
    
    // 按钮约束：底部距离遮罩视图20pt，左右对齐，高度40pt
    button.bottomAnchor.constraint(equalTo: myView.bottomAnchor, constant: -20),
    button.leadingAnchor.constraint(equalTo: myView.leadingAnchor),
    button.trailingAnchor.constraint(equalTo: myView.trailingAnchor),
    button.heightAnchor.constraint(equalToConstant: 40)
])

关键注意点 #

• 使用AutoLayout时，必须先将子视图添加到父视图，再设置并激活约束，否则会触发"无共同祖先"的异常。
• 所有使用AutoLayout的视图，都需要设置translatesAutoresizingMaskIntoConstraints = false，避免系统自动生成冲突的约束。
• 给按钮设置明确的背景色和文字颜色，防止因默认颜色与父视图背景色接近而导致按钮不可见。

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