SwiftUI TextField快捷键异常：程序化NSWindow vs SwiftUI原生场景

问题核心在于程序化创建的NSWindow默认没有配置系统标准编辑菜单，导致Command+a、复制粘贴这类依赖菜单keyEquivalent的快捷键无法被触发。以下是具体解决方案：

1. 给程序化NSWindow添加标准编辑菜单 #

系统的Command快捷键是通过菜单的快捷键绑定来触发的，缺少对应菜单时，快捷键事件会被系统忽略并触发提示音。直接给创建的NSWindow添加编辑菜单即可解决：

func setupCustomWindow() {
    // 创建窗口
    let window = NSWindow(
        contentRect: NSRect(x: 200, y: 200, width: 400, height: 300),
        styleMask: [.titled, .closable, .miniaturizable, .resizable],
        backing: .buffered, defer: false
    )
    window.center()
    
    // 构建标准编辑菜单
    let editMenu = NSMenu(title: "Edit")
    // 添加系统默认编辑菜单项及对应快捷键
    editMenu.addItem(withTitle: "Undo", action: #selector(NSResponder.undo(_:)), keyEquivalent: "z")
    editMenu.addItem(withTitle: "Redo", action: #selector(NSResponder.redo(_:)), keyEquivalent: "Z")
    editMenu.addItem(.separator())
    editMenu.addItem(withTitle: "Cut", action: #selector(NSResponder.cut(_:)), keyEquivalent: "x")
    editMenu.addItem(withTitle: "Copy", action: #selector(NSResponder.copy(_:)), keyEquivalent: "c")
    editMenu.addItem(withTitle: "Paste", action: #selector(NSResponder.paste(_:)), keyEquivalent: "v")
    editMenu.addItem(withTitle: "Select All", action: #selector(NSResponder.selectAll(_:)), keyEquivalent: "a")
    
    // 将编辑菜单添加到窗口主菜单
    let mainMenu = NSMenu()
    let editMenuItem = NSMenuItem(title: "Edit", action: nil, keyEquivalent: "")
    editMenuItem.submenu = editMenu
    mainMenu.addItem(editMenuItem)
    
    window.menu = mainMenu
    
    // 设置SwiftUI视图为窗口内容
    let hostingView = NSHostingView(rootView: YourTextFieldView())
    hostingView.autoresizingMask = [.width, .height]
    window.contentView = hostingView
    
    window.makeKeyAndOrderFront(nil)
}

2. 全局配置应用主菜单（可选） #

如果你的应用有多个程序化窗口，可以直接给NSApp设置全局主菜单，所有窗口都会继承这个菜单配置，无需重复设置：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    let mainMenu = NSMenu()
    
    // 添加编辑菜单（代码同上）
    let editMenu = NSMenu(title: "Edit")
    // ... 填充编辑菜单项
    
    let editMenuItem = NSMenuItem(title: "Edit", action: nil, keyEquivalent: "")
    editMenuItem.submenu = editMenu
    mainMenu.addItem(editMenuItem)
    
    NSApp.mainMenu = mainMenu
}

3. 程序化NSTextField的额外检查 #

对于纯AppKit的程序化NSTextField场景，除了确保窗口有编辑菜单，还要确认文本框能成为第一响应者：

func setupCustomTextFieldView() {
    let containerView = NSView(frame: NSRect(x: 0, y: 0, width: 400, height: 300))
    containerView.autoresizingMask = [.width, .height]
    
    let textField = NSTextField(frame: NSRect(x: 20, y: 20, width: 360, height: 24))
    textField.placeholderString = "测试文本框"
    containerView.addSubview(textField)
    
    // 确保文本框能获取焦点
    containerView.window?.makeFirstResponder(textField)
}

原理说明 #

SwiftUI的TextField底层依赖AppKit的NSTextField，系统的Command快捷键触发逻辑是：

1. 按下快捷键时，系统先查找当前窗口/应用的菜单中是否有对应keyEquivalent的菜单项
2. 如果找到，就将事件传递给当前第一响应者执行对应的action
3. 程序化创建的窗口默认没有这些菜单，所以快捷键无法被识别，只会触发系统提示音

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