如何让UIPageControl的currentPage在CollectionView滑动与按钮切换时保持一致？

你的核心问题出在滑动时的页码计算逻辑错误，以及按钮切换时的分页状态干扰，导致currentPage与实际显示的轮播项不一致，进而引发自动滚动异常。

问题根源 #

1. scrollViewDidEndDecelerating中页码计算错误：使用ceil(scrollView.contentOffset.x / scrollView.frame.size.width)仅适用于无重叠的全屏cell轮播，你的cell是重叠布局，contentOffset与页码的对应关系不再是整倍宽度，直接计算会得到错误页码。
2. 反复开关isPagingEnabled：按钮切换时来回开启/关闭分页，会打乱CollectionView的滚动状态，导致后续滑动时自动跳转到首尾cell。
3. 重复设置pageControl.currentPage：currentPage的didSet已经同步了pageControl状态，其他方法中重复设置会引发状态冲突。
4. 两个更新方法逻辑冗余：updateUI和updateButtonStates功能重叠，容易导致状态不一致。

修正后的完整代码 #

class ViewController: UIViewController, UICollectionViewDelegate, UICollectionViewDataSource {

    @IBOutlet private var collectionView: UICollectionView!
    @IBOutlet private var nextButton: UIButton!
    @IBOutlet private var previousButton: UIButton!
    @IBOutlet private var pageControl: UIPageControl!

    let images: [UIImage] = [image1, image2, image3, image4, image5]

    var currentPage: Int = 0 {
        didSet {
            pageControl.currentPage = currentPage
        }
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView.delegate = self
        collectionView.dataSource = self
        
        pageControl.numberOfPages = images.count
        pageControl.clipsToBounds = false
        
        // 初始化按钮状态
        updateButtonAndUIStates()
    }

    // MARK: - CollectionView DataSource
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        return images.count
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        // 替换为你的cell复用逻辑
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "YourCellID", for: indexPath) as! YourCustomCell
        cell.imageView.image = images[indexPath.item]
        return cell
    }

    // MARK: - ScrollView Delegate
    func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
        // 通过屏幕中心点获取当前居中显示的cell的indexPath
        guard let centerPoint = collectionView?.convert(collectionView!.center, to: collectionView!),
              let indexPath = collectionView?.indexPathForItem(at: centerPoint) else { return }
        
        currentPage = indexPath.item
        updateButtonAndUIStates()
    }

    // MARK: - Button Actions
    @IBAction func didTapOnPreviousButton(_ sender: Any) {
        guard currentPage > 0 else { return }
        currentPage -= 1
        collectionView.scrollToItem(
            at: IndexPath(item: currentPage, section: 0),
            at: .centeredHorizontally,
            animated: true)
        updateButtonAndUIStates()
    }

    @IBAction func didTapNextButton(_ sender: Any) {
        guard currentPage < images.count - 1 else { return }
        currentPage += 1
        collectionView.scrollToItem(
            at: IndexPath(item: currentPage, section: 0),
            at: .centeredHorizontally,
            animated: true)
        updateButtonAndUIStates()
    }

    // MARK: - UI Update
    private func updateButtonAndUIStates() {
        previousButton.isHidden = currentPage == 0
        previousButton.isEnabled = currentPage > 0
        
        nextButton.isHidden = currentPage == images.count - 1
        nextButton.isEnabled = currentPage < images.count - 1
    }
}

关键修正点说明 #

1. 滑动页码计算：通过collectionView.indexPathForItem(at: centerPoint)获取当前居中cell的索引，完全适配重叠布局的轮播场景。
2. 移除分页状态切换：直接使用scrollToItem完成按钮跳转，不再修改isPagingEnabled，避免滚动逻辑混乱。
3. 合并状态更新方法：将按钮状态和UI更新合并为updateButtonAndUIStates，确保状态统一。
4. 精简pageControl设置：仅通过currentPage的didSet同步pageControl，避免重复设置引发冲突。

内容的提问来源于stack exchange，提问作者Emre Değirmenci