iOS开发：如何创建在多个ViewController上保持固定的顶部header层

针对适配iPad iOS15、Xcode13 + Storyboard的开发场景，以下是可直接生效的UIWindow挂载实现方案，转场segue动画过程中Header不会跟随移动，支持运行时修改文本内容。

1. 第一步：创建自定义Header视图类 #

首先新建继承自UIView的自定义Header类，内置需要的所有控件，使用AutoLayout布局，对外暴露修改文本的接口：

import UIKit

class GlobalTopHeader: UIView {
    // 对外暴露可修改的Label
    let titleLabel: UILabel = {
        let label = UILabel()
        label.font = .systemFont(ofSize: 16, weight: .medium)
        label.textColor = .black
        return label
    }()
    
    let logoImageView: UIImageView = {
        let iv = UIImageView()
        iv.contentMode = .scaleAspectFit
        iv.image = UIImage(named: "your_logo_name") // 替换为你的logo资源名
        return iv
    }()
    
    let actionButton: UIButton = {
        let btn = UIButton(type: .system)
        btn.setTitle("操作", for: .normal)
        return btn
    }()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupUI()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupUI()
    }
    
    private func setupUI() {
        backgroundColor = .white // 可自定义背景色
        translatesAutoresizingMaskIntoConstraints = false
        
        // 添加子控件
        [logoImageView, titleLabel, actionButton].forEach {
            $0.translatesAutoresizingMaskIntoConstraints = false
            addSubview($0)
        }
        
        // 子控件布局（可根据需求调整）
        NSLayoutConstraint.activate([
            logoImageView.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 16),
            logoImageView.centerYAnchor.constraint(equalTo: centerYAnchor),
            logoImageView.widthAnchor.constraint(equalToConstant: 40),
            logoImageView.heightAnchor.constraint(equalToConstant: 40),
            
            titleLabel.leadingAnchor.constraint(equalTo: logoImageView.trailingAnchor, constant: 12),
            titleLabel.centerYAnchor.constraint(equalTo: centerYAnchor),
            
            actionButton.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -16),
            actionButton.centerYAnchor.constraint(equalTo: centerYAnchor),
            actionButton.widthAnchor.constraint(equalToConstant: 60)
        ])
        
        // 给按钮添加点击事件（可选）
        actionButton.addTarget(self, action: #selector(buttonTapped), for: .touchUpInside)
    }
    
    @objc private func buttonTapped() {
        // 处理按钮点击逻辑，可通过通知、闭包等方式对外传递事件
    }
}

2. 第二步：将Header挂载到当前Window #

iOS13之后引入了多场景（Scene）机制，旧的直接获取keyWindow的方法已废弃，需要从当前活跃场景中获取Window后挂载Header：

2.1 单例管理Header实例（方便全局调用） #

新建全局管理类，持有Header实例，统一处理挂载逻辑：

class GlobalHeaderManager {
    static let shared = GlobalHeaderManager()
    let headerView = GlobalTopHeader()
    private var currentWindow: UIWindow?
    
    private init() {}
    
    // 挂载Header到当前窗口
    func attachToCurrentWindow() {
        // 获取当前活跃的Window（适配iOS15+多场景）
        guard let windowScene = UIApplication.shared.connectedScenes
                .filter({ $0.activationState == .foregroundActive })
                .first as? UIWindowScene,
              let window = windowScene.windows.first(where: { $0.isKeyWindow }) else {
            return
        }
        currentWindow = window
        
        // 添加Header到Window
        window.addSubview(headerView)
        // 把Header提到最上层，避免被其他视图盖住
        window.bringSubviewToFront(headerView)
        
        // Header布局约束，高度可自定义
        let headerHeight: CGFloat = 60 // 可根据需求调整
        NSLayoutConstraint.activate([
            headerView.topAnchor.constraint(equalTo: window.safeAreaLayoutGuide.topAnchor),
            headerView.leadingAnchor.constraint(equalTo: window.leadingAnchor),
            headerView.trailingAnchor.constraint(equalTo: window.trailingAnchor),
            headerView.heightAnchor.constraint(equalToConstant: headerHeight)
        ])
    }
    
    // 全局修改Header标题的方法
    func updateHeaderTitle(_ text: String) {
        headerView.titleLabel.text = text
    }
}

2.2 调用挂载方法 #

在App启动完成后调用挂载逻辑：

• 如果你用了SceneDelegate，在scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions)方法末尾添加：

GlobalHeaderManager.shared.attachToCurrentWindow()

• 如果你没有使用Scene（仅用AppDelegate），在application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool方法末尾添加上面的代码即可。

3. 运行时修改Header文本 #

在任意ViewController中都可以直接调用管理类的方法修改Label内容：

// 示例：修改Header标题
GlobalHeaderManager.shared.updateHeaderTitle("新的标题内容")

4. 常见问题适配 #

• 转场动画固定效果：Header是直接挂载到Window层级，所有ViewController的segue转场动画都是ViewController自身视图的动画，不会影响Window层级的Header，天然满足转场时固定不动的需求
• 横竖屏适配：Header约束是相对Window设置，iPad横竖屏切换时会自动适配位置
• 避免被其他视图遮挡：如果遇到弹窗、系统控件盖住Header的情况，可以在需要的时候调用currentWindow?.bringSubviewToFront(headerView)调整层级

内容的提问来源于stack exchange，提问作者HydroMésange