SwiftUI：使用泛型实现List时的编译错误排查与修复

错误原因分析 #

1. 构造器重载混淆：SwiftUI的List存在多个构造器重载，编译器误将传入的[ScanItem]匹配到了需要Binding类型参数的构造器，导致类型不匹配。
2. 泛型参数推断失败：由于ScanProtocol是协议类型，编译器无法自动推断List的Data泛型参数，加上代码中存在属性调用错误，进一步干扰了编译流程。
3. 隐藏属性错误：Text里使用的item.identifier不存在，ScanItem的标识符属性是id（UUID类型），直接拼接需要先转为字符串。

具体修复步骤 #

• 修正属性调用：将item.identifier替换为item.id.uuidString，正确访问ScanItem的UUID标识符并转为字符串格式。
• 明确List构造器参数：显式指定List的数据源标识键，帮助编译器正确推断泛型参数，避免构造器匹配混淆。
• 调整协议属性权限：将ScanProtocol中的peripherals改为可读可写，确保实现类可以用@Published修饰该属性，触发视图更新。

修改后的完整代码 #

import Foundation
import SwiftUI

struct ScanItem: Hashable, Equatable, Identifiable {
    let id: UUID
    let name: String
    let rssi: Int
    let peripheral: Peripheral?
    
    func hash(into hasher: inout Hasher) {
        hasher.combine(id)
    }
    
    static func == (lhs: ScanItem, rhs: ScanItem) -> Bool {
        return lhs.id == rhs.id
    }
}

protocol ScanProtocol: ObservableObject {
    var isScanning: Bool { get }
    var peripherals: [ScanItem] { get set } // 修改为可读可写，支持@Published
    var error: String? { get }

    func startScan()
    func stopScan()
}

struct FoundDeviceListView<Model>: View where Model: ScanProtocol {
    @ObservedObject var scanModel: Model
    
    var body : some View {
        // 显式指定id，帮助编译器推断泛型参数
        List(scanModel.peripherals, id: \.id) { item in
            // 修正属性调用，将identifier改为id.uuidString
            Text("\(item.name) ( \(item.id.uuidString) ) \(item.rssi) dBm")
        }
    }
}

// 示例实现类（需符合ScanProtocol）
class ScanEmulator: ScanProtocol {
    @Published var isScanning = false
    @Published var peripherals: [ScanItem] = [] // 使用@Published触发视图更新
    var error: String? = nil
    
    func startScan() {
        // 模拟扫描逻辑，添加测试数据
        isScanning = true
        peripherals = [
            ScanItem(id: UUID(), name: "Device 1", rssi: -50, peripheral: nil),
            ScanItem(id: UUID(), name: "Device 2", rssi: -70, peripheral: nil)
        ]
    }
    
    func stopScan() {
        isScanning = false
        peripherals.removeAll()
    }
}

#Preview {
    @Previewable @StateObject var model = ScanEmulator()
    FoundDeviceListView(scanModel: model)
}

额外说明 #

如果你的ScanProtocol设计中peripherals必须是只读的，可以保留{ get }限制，但需要在实现类中确保peripherals被@Published修饰（即使是只读，也可以通过内部修改触发更新）。此时List的构造器仍需要显式指定id: \.id来帮助编译器推断类型。

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