Swift中如何通过约束在UITabBarViewController上显示引导层？

直接上可行方案，完全不用计算frame，解决你遇到的约束冲突和TabBar未覆盖问题：

核心思路 #

把引导层直接加到应用的keyWindow上，这样它能覆盖整个屏幕（包括TabBar、导航栏），同时因为所有控制器的视图最终都是window的子视图，引导层和目标视图拥有共同祖先（window），不会出现约束冲突报错。用遮罩实现高亮镂空，全程靠约束绑定目标视图的位置尺寸。

步骤1：创建全局引导容器 #

// 创建半透明覆盖层
let overlayView = UIView()
overlayView.backgroundColor = UIColor.black.withAlphaComponent(0.7)
// 如需点击穿透，可设为false，或者后续通过hitTest处理
overlayView.isUserInteractionEnabled = true

// 获取当前keyWindow
guard let window = UIApplication.shared.windows.first(where: { $0.isKeyWindow }) else { return }
window.addSubview(overlayView)

// 设置全屏约束，完全不用写frame
overlayView.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    overlayView.topAnchor.constraint(equalTo: window.topAnchor),
    overlayView.leadingAnchor.constraint(equalTo: window.leadingAnchor),
    overlayView.trailingAnchor.constraint(equalTo: window.trailingAnchor),
    overlayView.bottomAnchor.constraint(equalTo: window.bottomAnchor)
])

步骤2：绑定高亮区域到目标视图（纯约束） #

用CAShapeLayer做遮罩实现镂空效果，通过约束让高亮区域自动跟随目标视图的位置和尺寸：

// 替换成你需要高亮的目标视图（比如子控制器里的按钮/视图）
let targetView = yourTargetView

// 创建遮罩层，实现镂空效果
let maskLayer = CAShapeLayer()
maskLayer.fillRule = .evenOdd
overlayView.layer.mask = maskLayer

// 添加约束，直接绑定目标视图的宽高和位置到引导层（因为都在window下，约束合法）
NSLayoutConstraint.activate([
    // 高亮区域宽高和目标视图一致
    overlayView.widthAnchor.constraint(equalTo: targetView.widthAnchor),
    overlayView.heightAnchor.constraint(equalTo: targetView.heightAnchor),
    // 高亮区域的top/leading和目标视图对齐
    overlayView.topAnchor.constraint(equalTo: targetView.topAnchor),
    overlayView.leadingAnchor.constraint(equalTo: targetView.leadingAnchor)
])

// 监听布局变化，更新遮罩路径（适配旋转、视图刷新）
overlayView.addObserver(self, forKeyPath: "bounds", options: .new, context: nil)
targetView.addObserver(self, forKeyPath: "frame", options: .new, context: nil)

步骤3：处理布局更新 #

当目标视图或引导层布局变化时，自动更新遮罩：

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard let overlay = object as? UIView else { return }
    
    // 重新生成遮罩路径：全屏区域 + 高亮镂空区域
    let fullScreenPath = UIBezierPath(rect: overlay.bounds)
    let targetFrameInOverlay = targetView.convert(targetView.bounds, to: overlay)
    let highlightPath = UIBezierPath(rect: targetFrameInOverlay)
    
    fullScreenPath.append(highlightPath)
    (overlay.layer.mask as? CAShapeLayer)?.path = fullScreenPath.cgPath
}

步骤4：可选实现点击穿透 #

如果需要点击高亮区域外的地方能触发下层视图的交互，重写引导层的hitTest：

extension UIView {
    // 可以给引导层添加这个扩展，或者直接在自定义引导类里实现
    override open func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
        guard let targetView = yourTargetView else { return nil }
        let targetFrame = targetView.convert(targetView.bounds, to: self)
        // 只有点击高亮区域时，才响应交互；其他区域直接穿透
        return targetFrame.contains(point) ? super.hitTest(point, with: event) : nil
    }
}

为什么这个方案能解决你的问题 #

1. 引导层加在window上，自动覆盖TabBar，无需拆分两个视图；
2. 所有约束绑定的视图都在window的视图链里，不存在"无共同祖先"的报错；
3. 全程用约束绑定目标视图，完全不用手动计算frame，适配各种屏幕和布局变化。

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