SwiftUI List单点击选响应缓慢问题排查求助

我想要创建一个简单的SwiftUI List，列表项支持单点击选：

• iOS 18系统上，列表项需响应双击、三击、长按操作
• macOS 17系统上，列表项需响应双击、长按、右键点击操作
  所有点击操作要能识别整行区域（文本及后方空白处）。

我编写了如下代码，功能上能满足需求，但单点击选列表项时响应十分迟缓，请问可能的原因是什么？

struct ContentView: View {
  let items = ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"]
  @State private var selectedItem: String? = nil
  @State private var systemMessage: String = ""
  
  var body: some View {
    VStack(spacing: 20) {
      Text(selectedItem ?? "Nothing selected")
      List(items, id: \.self) { item in
        HStack {
          Text(item)
            .padding()
          Spacer()
        }
        .background(selectedItem == item ? Color.gray.opacity(0.3) : Color.clear) // show selection
        .contentShape(Rectangle()) // make whole hStack Clickable
        
#if os(iOS)   // under MacOS and iOS 17 doubvleclick not detected, if .onTapGesture (count: 3) activ
        .onTapGesture (count: 3) {
          systemMessage = "triple-click: \(item)"
          selectedItem = item
        }
#endif
        .onTapGesture (count: 2) {
          systemMessage = "double-click: \(item)"
          selectedItem = item
        }
        
        .onTapGesture(count: 1) {
          systemMessage = "single click: \(item)"
          selectedItem =  item
        }
        
#if os(macOS)
        
        .onLongPressGesture {
          selectedItem =  item
          systemMessage = "longpress: \(item)"
        }
#endif
        .contextMenu {
          Button("Context Menue 1") {
            systemMessage = "Context Menue 1: \(item)"
          }
          Button("Context Menue 2") {
            systemMessage = "Context Menue 2: \(item)"
          }
        }
        
      }
      Text(systemMessage)
        .font(.subheadline)
        .foregroundColor(.gray)
        .padding(.top, 10)
      
      Spacer()
    }
    .padding()
  }
}

单点击响应迟缓的核心原因是多个独立onTapGesture修饰符的叠加：

当你同时添加单点击、双击（iOS下还有三击）手势时，SwiftUI的手势识别系统会进入等待状态——它需要确认用户是否会继续点击以触发更高次数的手势（比如单点击后，系统要等待几百毫秒判断是否会触发双击），只有超时后才会执行单点击回调，这就导致了明显的延迟。

另外，contextMenu和longPressGesture（macOS）的识别优先级也会和点击手势产生冲突，进一步加剧延迟感。

要解决这个问题，需要将多击手势合并为一个逻辑明确的手势组，避免系统的无意义等待：

方案1：使用exclusively(before:)绑定手势优先级 #

通过exclusively(before:)让高次数点击手势优先被识别，低次数手势仅在高次数手势未触发时执行，消除系统等待逻辑：

struct ContentView: View {
  let items = ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"]
  @State private var selectedItem: String? = nil
  @State private var systemMessage: String = ""
  
  var body: some View {
    VStack(spacing: 20) {
      Text(selectedItem ?? "Nothing selected")
      List(items, id: \.self) { item in
        HStack {
          Text(item)
            .padding()
          Spacer()
        }
        .background(selectedItem == item ? Color.gray.opacity(0.3) : Color.clear)
        .contentShape(Rectangle())
        
        // 合并点击手势，明确优先级
        .gesture(
          #if os(iOS)
          // iOS：三击 → 双击 → 单点击的优先级顺序
          TapGesture(count: 3)
            .onEnded {
              systemMessage = "triple-click: \(item)"
              selectedItem = item
            }
            .exclusively(before: TapGesture(count: 2)
              .onEnded {
                systemMessage = "double-click: \(item)"
                selectedItem = item
              }
              .exclusively(before: TapGesture(count: 1)
                .onEnded {
                  systemMessage = "single click: \(item)"
                  selectedItem = item
                }))
          #else
          // macOS：双击 → 单点击的优先级顺序
          TapGesture(count: 2)
            .onEnded {
              systemMessage = "double-click: \(item)"
              selectedItem = item
            }
            .exclusively(before: TapGesture(count: 1)
              .onEnded {
                systemMessage = "single click: \(item)"
                selectedItem = item
              })
          #endif
        )
        
        // 统一处理长按手势
        .onLongPressGesture {
          selectedItem = item
          systemMessage = "longpress: \(item)"
        }
        
        .contextMenu {
          Button("Context Menu 1") {
            systemMessage = "Context Menu 1: \(item)"
          }
          Button("Context Menu 2") {
            systemMessage = "Context Menu 2: \(item)"
          }
        }
      }
      Text(systemMessage)
        .font(.subheadline)
        .foregroundColor(.gray)
        .padding(.top, 10)
      
      Spacer()
    }
    .padding()
  }
}

方案2：复用List原生选中机制 #

如果单点击仅用于选中项，直接使用List的原生selection绑定，既能获得最快的响应速度，又能避免自定义手势冲突：

struct ContentView: View {
  let items = ["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"]
  @State private var selectedItem: String? = nil
  @State private var systemMessage: String = ""
  
  var body: some View {
    VStack(spacing: 20) {
      Text(selectedItem ?? "Nothing selected")
      // 用List原生selection实现单点击选中
      List(items, id: \.self, selection: $selectedItem) { item in
        HStack {
          Text(item)
            .padding()
          Spacer()
        }
        .background(selectedItem == item ? Color.gray.opacity(0.3) : Color.clear)
        .contentShape(Rectangle())
        
        // 仅处理多击手势
        .gesture(
          #if os(iOS)
          TapGesture(count: 3)
            .onEnded {
              systemMessage = "triple-click: \(item)"
            }
            .exclusively(before: TapGesture(count: 2)
              .onEnded {
                systemMessage = "double-click: \(item)"
              })
          #else
          TapGesture(count: 2)
            .onEnded {
              systemMessage = "double-click: \(item)"
            }
          #endif
        )
        
        .onLongPressGesture {
          systemMessage = "longpress: \(item)"
        }
        
        .contextMenu {
          Button("Context Menu 1") {
            systemMessage = "Context Menu 1: \(item)"
          }
          Button("Context Menu 2") {
            systemMessage = "Context Menu 2: \(item)"
          }
        }
      }
      Text(systemMessage)
        .font(.subheadline)
        .foregroundColor(.gray)
        .padding(.top, 10)
      
      Spacer()
    }
    .padding()
    // iOS下开启List编辑模式（可选）
    .navigationTitle("Items")
    .toolbar {
      #if os(iOS)
      EditButton()
      #endif
    }
  }
}

关键说明 #

• exclusively(before:) 确保高次数手势优先被识别，系统无需等待判断，单点击响应会立即触发。
• 复用List原生selection绑定，完全使用系统的单点击选中逻辑，响应速度最快，同时避免自定义手势的冲突。

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