SwiftUI与UIKit跨层通用绑定报错：Cannot find '$item' in scope

问题根源 #

纯SwiftUI场景里，@Observable对象的$item绑定符号是视图层级自动支持的语法糖，但跨到UIKit容器（比如UICollectionViewCell包裹SwiftUI视图）时，SwiftUI的绑定上下文不存在了，直接写$item自然找不到。这时候必须用Bindable手动桥接Observable对象和绑定。

具体修复步骤 #

1. 确认模型定义没问题 #

先确保你的Car模型和ItemViewable协议符合@Observable要求：

protocol ItemViewable: Observable {
    var name: String { get set }
    var id: UUID { get }
}

@Observable
final class Car: ItemViewable {
    var name: String
    let id = UUID()
    
    init(name: String) {
        self.name = name
    }
}

2. 修改ItemViewContainer的setupItem方法 #

在UIKit的Cell容器里，用Bindable包装Observable对象，再生成绑定传给SwiftUI视图：

class ItemViewContainer: UICollectionViewCell {
    private var hostingVC: UIHostingController<AnyView>?
    
    func setupItem<T: ItemViewable>(_ item: T) {
        // 核心操作：用Bindable包装Observable实例，拿到可绑定的引用
        let bindableItem = Bindable(item)
        
        // 给SwiftUI视图传绑定时，用bindableItem.$item
        let swiftUIView = ItemInfo(item: bindableItem.$item)
        
        hostingVC = UIHostingController(rootView: AnyView(swiftUIView))
        hostingVC?.view.translatesAutoresizingMaskIntoConstraints = false
        
        contentView.subviews.forEach { $0.removeFromSuperview() }
        contentView.addSubview(hostingVC!.view)
        
        NSLayoutConstraint.activate([
            hostingVC!.view.topAnchor.constraint(equalTo: contentView.topAnchor),
            hostingVC!.view.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
            hostingVC!.view.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
            hostingVC!.view.bottomAnchor.constraint(equalTo: contentView.bottomAnchor)
        ])
    }
}

3. 确保ItemInfo泛型视图接受绑定参数 #

你的SwiftUI泛型视图要定义成接受@Binding类型：

struct ItemInfo<T: ItemViewable>: View {
    @Binding var item: T
    
    var body: some View {
        TextField("车型名称", text: $item.name)
        // 其他展示/编辑item属性的视图
    }
}

4. UIViewRepresentable中的适配 #

在封装UICollectionView的UIViewRepresentable里，直接把Observable实例传给Cell即可：

struct CollectionViewWrapper: UIViewRepresentable {
    @State var items: [any ItemViewable]
    
    func makeUIView(context: Context) -> UICollectionView {
        let layout = UICollectionViewFlowLayout()
        layout.itemSize = CGSize(width: UIScreen.main.bounds.width - 32, height: 80)
        let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
        collectionView.register(ItemViewContainer.self, forCellWithReuseIdentifier: "ItemCell")
        collectionView.dataSource = context.coordinator
        return collectionView
    }
    
    func updateUIView(_ uiView: UICollectionView, context: Context) {
        uiView.reloadData()
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, UICollectionViewDataSource {
        let parent: CollectionViewWrapper
        
        init(_ parent: CollectionViewWrapper) {
            self.parent = parent
        }
        
        func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
            parent.items.count
        }
        
        func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
            let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "ItemCell", for: indexPath) as! ItemViewContainer
            cell.setupItem(parent.items[indexPath.item])
            return cell
        }
    }
}

重点提醒 #

Bindable就是专门用来解决这种跨层绑定问题的工具——它把@Observable对象包装成一个能生成@Binding的实例，让UIKit代码也能拿到SwiftUI需要的绑定引用。纯SwiftUI场景下视图自动处理了这个包装，所以不用手动写，但跨层时必须显式调用。

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