Swift中NSCollectionView可选择时NSViewController的keyDown方法无法触发

问题原因 #

当NSCollectionView的selectable属性设为true时，它会默认成为第一响应者接收所有键盘事件，默认实现里不会将未处理的事件向上传递到响应链，因此上层视图控制器的keyDown方法不会被触发。

可行解决方案 #

方案1：自定义NSCollectionView子类转发事件（最推荐，不影响CollectionView原有选中逻辑）

重写CollectionView的keyDown方法，将不需要自身处理的事件转发给响应链的下一个响应者：

class CustomCollectionView: NSCollectionView {
    override func keyDown(with event: NSEvent) {
        // 保留CollectionView原生支持的上下方向键切换选中逻辑
        let nativeHandleKeys: [UInt16] = [125, 126] // 下箭头、上箭头对应的keyCode
        if nativeHandleKeys.contains(event.keyCode) {
            super.keyDown(with: event)
            return
        }
        // 其余事件转发给上层响应者（即你的视图控制器）
        nextResponder?.keyDown(with: event)
    }
}

将你原有NSCollectionView的类替换为该自定义子类即可。

方案2：视图控制器实现performKeyEquivalent方法（适合全局捕获当前VC内的按键）

该方法会在响应链收到按键事件前优先触发，且可以自行判断当前VC是否处于聚焦状态，避免误触发：

class MyViewController: NSViewController {
    weak var collectionView: NSCollectionView!
    
    override func performKeyEquivalent(with event: NSEvent) -> Bool {
        // 校验当前VC的视图是否在窗口响应链中，避免VC未聚焦时触发
        guard view.window?.firstResponder?.isDescendant(of: view) ?? false else {
            return false
        }
        // 此处写你的按键处理逻辑
        print("Key pressed.")
        // 返回true表示事件已处理，不再向下传递；返回false则继续走默认响应链逻辑
        return true
    }
}

方案3：禁用CollectionView的第一响应者资格（适合不需要键盘操作CollectionView的场景）

如果你的业务不需要用键盘切换CollectionView的选中状态，可以直接设置CollectionView拒绝成为第一响应者，所有按键事件会自动向上传递：

collectionView.refusesFirstResponder = true

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