Cocoa应用切换视图时如何设置初始firstResponder？

核心原因 #

你遇到的问题本质是：目标UI元素还未加入当前窗口的视图层级时，调用makeFirstResponder(_:)会直接失败。viewWillAppear、viewDidAppear甚至视图初始化阶段，目标元素的window属性大概率还是nil，系统自然会报错“不在当前窗口”。

简便解决方案 #

1. 利用NSView的initialFirstResponder属性（推荐）

这正是你要找的「指定键视图循环入口点」的官方简便方法。直接在自定义视图中设置该属性为目标UI元素，当视图成为窗口的主视图时，系统会自动将其设为第一响应者。

示例代码：

class MyCustomView: NSView {
    let targetTextField = NSTextField()
    
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        setupSubviews()
        // 指定键视图循环的入口点
        self.initialFirstResponder = targetTextField
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupSubviews() {
        targetTextField.frame = NSRect(x: 20, y: 20, width: 200, height: 24)
        targetTextField.placeholderString = "自动成为第一响应者"
        addSubview(targetTextField)
    }
}

2. 在didMoveToWindow中触发becomeFirstResponder

当视图真正加入窗口层级时，didMoveToWindow方法会被调用，此时目标元素的window属性已有效。可以在自定义视图中重写该方法，直接让目标元素成为第一响应者：

示例代码：

class MyCustomView: NSView {
    let targetTextField = NSTextField()
    
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        setupSubviews()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupSubviews() {
        targetTextField.frame = NSRect(x: 20, y: 20, width: 200, height: 24)
        targetTextField.placeholderString = "自动成为第一响应者"
        addSubview(targetTextField)
    }
    
    override func didMoveToWindow() {
        super.didMoveToWindow()
        // 确保视图已加入窗口，再设置第一响应者
        if let window = self.window {
            window.makeFirstResponder(targetTextField)
        }
    }
}

3. 在ViewController中延迟执行（备选）

如果需要在ViewController层面控制，可以使用DispatchQueue.main.async将makeFirstResponder的调用推迟到当前事件循环结束后，确保视图层级已更新：

示例代码：

class ViewController: NSViewController {
    func switchToNewView() {
        let newView = MyCustomView(frame: self.view.bounds)
        self.view = newView
        
        // 延迟到当前循环结束后执行
        DispatchQueue.main.async { [weak self] in
            guard let targetField = (self?.view as? MyCustomView)?.targetTextField else { return }
            self?.view.window?.makeFirstResponder(targetField)
        }
    }
}

关于becomeFirstResponder未触发的说明 #

你重写的becomeFirstResponder方法未被触发，是因为只有当目标元素满足以下条件时，调用becomeFirstResponder才会生效：

• 元素已加入窗口的视图层级（window属性非nil）
• 元素的acceptsFirstResponder返回true（默认文本输入控件等已开启，自定义控件需手动设置）

之前的调用时机不满足第一个条件，所以方法不会被触发。

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