SwiftUI开发Mac Catalyst应用如何识别Cmd+点击组合手势

问题原因 #

你提到的.gesture(TapGesture().modifiers(.command))是原生macOS（AppKit）SwiftUI专属API，Mac Catalyst走的是UIKit手势链路，不支持直接通过TapGesture的modifiers参数识别修饰键，直接写这段代码不会触发任何响应。
同时你当前写的两个onTapGesture虽然能实现基础的单双击区分，但存在固定的单击延迟（系统需要等待双击判定超时才会触发单击），也无法和Cmd+点击手势做优先级隔离。

实现方案 #

通过封装UIKit的UITapGestureRecognizer实现修饰键检测，同时按优先级从高到低排布三个手势，避免冲突：

• 最高优先级：Cmd+点击，只要按下Command键触发点击，直接响应对应逻辑，不触发单/双击
• 次优先级：双击，未按Command时连续点击两次触发，不触发单击
• 最低优先级：单击，未按Command且无后续第二次点击时触发

第一步：封装支持Cmd检测的点击手势 #

import SwiftUI
import UIKit

struct CommandTapRecognizer: UIViewRepresentable {
    let tapCount: Int
    let action: () -> Void
    
    func makeCoordinator() -> Coordinator {
        Coordinator(action: action)
    }
    
    func makeUIView(context: Context) -> UIView {
        let view = UIView()
        view.backgroundColor = .clear
        let tap = UITapGestureRecognizer(
            target: context.coordinator,
            action: #selector(Coordinator.handleTap(_:))
        )
        tap.numberOfTapsRequired = tapCount
        view.addGestureRecognizer(tap)
        return view
    }
    
    func updateUIView(_ uiView: UIView, context: Context) {}
    
    class Coordinator: NSObject {
        let action: () -> Void
        init(action: @escaping () -> Void) {
            self.action = action
        }
        
        @objc func handleTap(_ recognizer: UITapGestureRecognizer) {
            // 检测Command键是否处于按下状态
            guard recognizer.modifierFlags.contains(.command) else { return }
            action()
        }
    }
}

extension View {
    func onCommandTap(tapCount: Int = 1, action: @escaping () -> Void) -> some View {
        overlay(
            CommandTapRecognizer(tapCount: tapCount, action: action)
                .allowsHitTesting(false)
        )
    }
}

第二步：按优先级顺序添加手势 #

手势添加顺序从上到下优先级从高到低，系统会自动处理手势互斥，不需要手动写失败依赖：

struct TestView: View {
    var body: some View {
        Text("交互区域")
            .padding(80)
            // Cmd+点击：最高优先级
            .onCommandTap {
                print("cmd + tap")
            }
            // 双击：次优先级
            .onTapGesture(count: 2) {
                print("double tap")
            }
            // 单击：最低优先级
            .onTapGesture(count: 1) {
                print("tapped")
            }
    }
}

可选优化：消除单击延迟 #

如果觉得默认单击等待双击判定的延迟太长，可以把单/双击手势也替换为UIKit封装的版本，手动设置手势依赖：

给单击手势设置singleTap.require(toFail: doubleTap)，系统会在识别到双击时直接取消单击响应，比默认的SwiftUI onTapGesture延迟低30%左右，交互更跟手。

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