UIViewRepresentable中UICollectionView视图出现时如何滚动到指定位置

问题原因 #

直接把滚动代码放在makeUIView中会失效，因为该方法执行时UICollectionView仅完成初始化，还未加载数据、完成布局计算，此时调用scrollToItem找不到对应IndexPath的元素，不会产生任何效果。如果直接不加判断放在updateUIView中，会在每次SwiftUI状态更新时重复触发滚动，打断用户正常交互。

实现思路 #

• 移除原代码中将UICollectionView作为结构体存储属性的写法，避免值类型持有UIKit引用类型导致的生命周期异常，UICollectionView实例统一在makeUIView中创建，由系统托管生命周期
• 在Coordinator中增加单次滚动标记，保证初始滚动逻辑仅执行一次，不影响后续用户交互
• 滚动逻辑放在updateUIView中，该方法会在视图首次加载、绑定状态（如列表数据）更新时自动触发，可兼容同步/异步加载数据的场景
• 滚动前先校验目标item是否存在、强制完成布局计算，避免布局未完成导致的滚动位置偏移、失效问题
• 滚动时关闭动画，指定目标位置停靠在列表顶部，完全匹配需求

修正后完整代码 #

struct CollectionViewRepresentable: UIViewRepresentable {
    
    @StateObject var vm = CollectionViewModel()

    func makeUIView(context: Context) -> UICollectionView {
        // 在makeUIView中创建collectionView实例，不做结构体存储属性
        let configuration = UICollectionLayoutListConfiguration(appearance: .plain)
        let collectionView = UICollectionView(
            frame: .zero,
            collectionViewLayout: UICollectionViewCompositionalLayout.list(using: configuration)
        )
        collectionView.backgroundColor = .clear
        collectionView.dataSource = context.coordinator
        collectionView.delegate = context.coordinator
        collectionView.register(ListCell.self, forCellWithReuseIdentifier: "listCell")
        return collectionView
    }

    func updateUIView(_ uiView: UICollectionView, context: Context) {
        let targetIndexPath = IndexPath(row: 25, section: 0)
        let coordinator = context.coordinator
        // 已完成过初始滚动则直接返回，避免重复触发
        guard !coordinator.hasScrolledToInitialPosition else { return }
        // 校验目标位置的item是否已经加载
        guard uiView.numberOfItems(inSection: 0) > targetIndexPath.row else { return }
        // 强制完成布局，确保位置计算准确
        uiView.layoutIfNeeded()
        // 执行无动画滚动，目标item停靠顶部
        uiView.scrollToItem(at: targetIndexPath, at: .top, animated: false)
        // 标记初始滚动完成
        coordinator.hasScrolledToInitialPosition = true
    }

    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }

    class Coordinator: NSObject, UICollectionViewDelegate, UICollectionViewDataSource {
        private var parent: CollectionViewRepresentable
        // 新增标记：是否已经完成初始位置滚动
        var hasScrolledToInitialPosition = false

        init(_ collectionViewRepresentable: CollectionViewRepresentable) {
            self.parent = collectionViewRepresentable
        }

        func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
            return parent.vm.items.count
        }

        func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
            let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "listCell", for: indexPath) as! ListCell
            let item = parent.vm.items[indexPath.row]
            cell.item = item
            return cell
        }
    }
}

补充说明 #

如果列表数据是异步加载的（比如网络请求返回后才给vm.items赋值），这个实现也能正常工作：当vm.items更新时，SwiftUI会自动调用updateUIView，此时判断到数据量满足要求、还未执行过初始滚动，就会自动完成滚动操作，不需要额外加通知或者回调。

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