macOS SwiftUI中子视图.keyboardShortcut无响应，如何解决？

你的问题核心在于：NavigationLink跳转后的视图默认未成为第一响应者，且NavigationView的层级结构会导致键盘事件被侧边栏或根视图拦截，无法传递到目标视图。以下是几种可行的解决方案：

方案一：让目标视图主动获取焦点 #

通过给目标视图容器添加focusable()修饰符，并在视图出现时主动设置第一响应者，确保键盘事件能传递到绑定快捷键的视图：

let days = ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"]

var body: some View {
    NavigationView {
        List {
            ForEach(days, id:\.self) { item in
                NavigationLink {
                    // 用VStack作为统一容器，添加焦点支持
                    VStack {
                        Text(item)
                        HStack {
                            ForEach(0..<7, id:\.self) { i in
                                Text("Hour" + String(i))
                                    .onTapGesture {
                                        print("tap")
                                    }
                                    .keyboardShortcut("l")
                            }
                        }
                    }
                    .focusable()
                    .onAppear {
                        DispatchQueue.main.async {
                            // 先清空当前第一响应者，再让主视图容器获取焦点
                            NSApp.keyWindow?.makeFirstResponder(nil)
                            NSApp.keyWindow?.makeFirstResponder(NSApp.keyWindow?.contentView)
                        }
                    }
                } label: {
                    Text(item)
                }
            }
        }
        Text("Select an item")
    }
}

方案二：注册全局快捷键（跨视图场景） #

如果快捷键需要在整个应用内触发（无需依赖当前视图焦点），可以通过commands注册全局快捷键，配合ObservableObject传递事件到目标视图：

1. 定义全局状态对象 #

class AppActionState: ObservableObject {
    @Published var triggerHourAction = false
}

2. 在App结构体中注册全局快捷键并注入状态 #

@main
struct YourMacApp: App {
    @StateObject private var actionState = AppActionState()
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(actionState)
        }
        .commands {
            CommandMenu("Custom Operations") {
                Button("Trigger Hour Action") {
                    actionState.triggerHourAction.toggle()
                }
                .keyboardShortcut("l")
            }
        }
    }
}

3. 在目标视图中监听事件 #

// 在ContentView中声明环境对象
@EnvironmentObject private var actionState: AppActionState

// 修改NavigationLink的目标视图
NavigationLink {
    VStack {
        Text(item)
        HStack {
            ForEach(0..<7, id:\.self) { i in
                Text("Hour" + String(i))
                    .onTapGesture {
                        print("tap")
                    }
                    .onReceive(actionState.$triggerHourAction) { triggered in
                        if triggered {
                            print("Hour \(i) action triggered via shortcut")
                            actionState.triggerHourAction = false // 重置状态避免重复触发
                        }
                    }
            }
        }
    }
} label: {
    Text(item)
}

方案三：自定义NSView容器管理第一响应者 #

对于复杂视图场景，可以通过NSViewRepresentable自定义一个支持焦点的容器，确保视图能捕获键盘事件：

struct FocusableContainer: NSViewRepresentable {
    let content: () -> View
    
    func makeNSView(context: Context) -> NSView {
        let view = NSView()
        view.wantsLayer = true
        return view
    }
    
    func updateNSView(_ nsView: NSView, context: Context) {}
    
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    class Coordinator: NSObject, NSResponder {
        override var acceptsFirstResponder: Bool { true }
    }
}

// 使用方式
NavigationLink {
    FocusableContainer {
        VStack {
            Text(item)
            HStack {
                ForEach(0..<7, id:\.self) { i in
                    Text("Hour" + String(i))
                        .onTapGesture {
                            print("tap")
                        }
                        .keyboardShortcut("l")
                }
            }
        }
    }
    .onAppear {
        DispatchQueue.main.async {
            NSApp.keyWindow?.makeFirstResponder(NSApp.keyWindow?.contentView?.subviews.first)
        }
    }
} label: {
    Text(item)
}

注意事项 #

• 若多个视图绑定同一快捷键，需通过状态判断确保只有当前活跃视图响应，避免冲突
• 视图级快捷键适合与当前视图内容强关联的操作，全局快捷键适合跨视图的通用操作
• macOS中第一响应者是键盘事件传递的关键，只有成为第一响应者的视图才能接收键盘事件

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