Swift中设置scrollToItem后手动滚动UICollectionView出现跳变问题

这个问题我之前也碰到过，核心原因是viewDidLayoutSubviews()会被频繁调用——不光是初始化、屏幕旋转这类场景，用户滑动UICollectionView的时候，只要布局有细微调整，这个方法都会触发。你每次都在里面执行scrollToItem，相当于强制把滚动位置拉回指定item，自然会打断正常的滑动手势，出现跳回的现象。

给你几个可行的解决方案：

• 限制滚动触发的时机
  加一个布尔标记，只在第一次布局的时候执行滚动逻辑，后续布局变化就不再触发。代码可以这么写：

  private var shouldScrollToTarget = true
  
  override func viewDidLayoutSubviews() {
      super.viewDidLayoutSubviews()
      
      guard shouldScrollToTarget else { return }
      let targetIndexPath = IndexPath(item: itemIndex, section: 0)
      collectionView.scrollToItem(at: targetIndexPath, at: .centeredHorizontally, animated: false)
      shouldScrollToTarget = false
  }
  

  这样只有视图第一次完成布局时会定位到指定item，后续滑动操作就不会被干扰了。

• 单独封装滚动方法，按需调用
  如果需要在某些特定场景（比如数据刷新、用户切换tab后）重新定位，别把滚动逻辑放在viewDidLayoutSubviews里，单独写个方法：

  func scrollToTargetItemIfNeeded() {
      let targetIndexPath = IndexPath(item: itemIndex, section: 0)
      // 如果目标item已经在可见范围内，就不用重复滚动了
      guard !collectionView.indexPathsForVisibleItems.contains(targetIndexPath) else {
          return
      }
      collectionView.scrollToItem(at: targetIndexPath, at: .centeredHorizontally, animated: false)
  }
  

  然后在需要的地方调用它，比如viewDidLoad之后、数据更新完成后，这样能精准控制滚动时机，不会干扰用户的正常滑动。

• 检查其他可能的干扰点
  确认一下有没有在viewWillAppear、viewDidAppear或者数据刷新的回调里也调用了scrollToItem，重复的滚动指令也可能导致这种跳回问题。

另外要注意，如果你用了自定义的UICollectionViewLayout，确保布局的prepare()方法没有做会触发viewDidLayoutSubviews的额外操作，避免间接导致滚动逻辑重复执行。

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