企业官网建设流程全解析

简介：这是一份面向iOS开发者的图片轮播组件源码，基于UIScrollView实现无限循环滚动效果，适合需要在应用中快速集成轮播图的中初级开发者参考与复用。源码支持加载网络图片、图片点击响应、pageControl显示开关、自动滚动开关以及滚动时间间隔设置，覆盖了轮播场景中的常见需求。资源包共106个文件，约659KB，以50个.h头文件与22个.m实现文件为核心，另含plist配置、xcconfig构建配置、xcscheme方案、xib界面、podfile依赖声明及png、gif等素材，并集成SDWebImage相关头文件用于网络图片缓存与下载。目前已有416人学习下载。通过阅读源码，读者可以理解UIScrollView循环滚动的实现思路、自动滚动定时器控制、网络图片异步加载与缓存处理，以及pageControl与点击事件的联动方式，便于直接移植到自己的项目中或在此基础上二次开发。

1. 图片轮播 UIScrollView 循环滚动：从“能跑”到“敢上线”的距离

很多 iOS 项目里都有图片轮播，但真正敢直接上线的没几个。我见过太多团队用 UIScrollView 拼三张图做循环，结果快速滑动时白屏、内存暴涨、定时器跟手势打架，最后只能换成第三方库。这份 iOS 源码资源就是冲着这些痛点来的——它用 UIScrollView 实现无限循环轮播，核心思路是“三视图复用 + 索引重映射”，不依赖任何第三方库，纯原生代码。适合两类人：一是刚接触 UIScrollView 分页机制、想搞懂循环原理的新手；二是被第三方轮播库坑过、想自己掌控每一行代码的老手。下面我按“原理拆解 → 代码落地 → 参数调优 → 避坑排查”的顺序，把这份源码里里外外翻一遍。

2. 循环滚动的底层逻辑：为什么是三个视图而不是无限个

2.1 UIScrollView 分页机制与循环的天然矛盾

UIScrollView 的pagingEnabled属性让滚动按页停靠，但它本身只认 contentSize 范围内的内容。假设你有 5 张图，contentSize 宽度就是 5 屏宽，滚到第 5 张再往右就到底了，不会自动回到第 1 张。常见的“伪循环”做法是把第 1 张复制一份放到第 5 张后面，滚到复制品时瞬间无动画跳回真正的第 1 张。这个方案能跑，但有两个硬伤：一是快速滑动时跳转时机不好把握，容易闪一下；二是图片数量多时 contentSize 无限膨胀，内存扛不住。

这份源码换了个思路：屏幕上永远只保留三个 UIImageView，分别对应当前页、前一页、后一页。滚动结束后，把这三个视图的内容重新映射到正确的图片索引上，同时把 contentOffset 重置到中间那一页。这样无论你有 100 张还是 1000 张图，内存里始终只有三个视图对象。代价是每次滚动结束都要做一次索引重算和视图重排，逻辑比“复制首尾”复杂，但换来的是稳定的内存占用和丝滑的循环体验。

2.2 三视图复用的索引映射算法

核心算法可以用一句话概括：维护一个currentIndex，三视图分别显示(currentIndex - 1 + count) % count、currentIndex、(currentIndex + 1) % count。滚动结束后根据偏移方向更新currentIndex，然后重新计算三个视图该显示哪张图，最后把 contentOffset 设回中间页。

这里有个容易翻车的细节：取模运算在 Swift 和 Objective-C 里对负数的处理不一样。比如-1 % 5在 Swift 里是-1，不是4。所以必须写成(currentIndex - 1 + count) % count，先加 count 再取模，保证结果非负。源码里专门封装了一个safeIndex(_ index: Int) -> Int方法处理这个边界，后面代码部分会展开。

另一个细节是滚动方向判断。不能只看contentOffset.x和中间页的差值正负，因为用户可能快速来回滑。稳妥做法是结合scrollView.panGestureRecognizer.translation(in:)的方向和最终停靠页来判断。源码里用的是“停靠页索引对比法”：滚动结束后计算page = round(contentOffset.x / pageWidth)，如果 page 是 0 说明往左滑了，page 是 2 说明往右滑了，page 是 1 说明没动。这个方法比手势方向更可靠，因为 UIScrollView 的减速动画可能让最终停靠页和手势方向不一致。

2.3 定时器自动轮播与手势的优先级处理

自动轮播一般用Timer或CADisplayLink。这份源码用的是Timer.scheduledTimer，间隔 3 秒，在scrollViewDidEndDecelerating和scrollViewDidEndDragging里重置定时器。为什么要重置？因为如果用户正在手动滑动，定时器突然触发自动翻页，两个动画会打架，出现“滑到一半被拽走”的玄学现象。

更隐蔽的坑是：Timer在滚动过程中也会触发。如果不在scrollViewWillBeginDragging里暂停定时器，用户按住屏幕不放时，定时器仍然在跑，松手后可能连续触发两次翻页。源码的处理是在scrollViewWillBeginDragging里timer.invalidate()，在scrollViewDidEndDragging里重新创建。注意scrollViewDidEndDragging有个decelerate参数，如果为 true 说明还有惯性滚动，要等scrollViewDidEndDecelerating再重启定时器，否则会在减速过程中插入自动翻页。

3. 源码落地：从初始化到滚动的完整代码拆解

3.1 初始化三视图与内容尺寸设置

先看初始化部分。假设图片数组是images: [UIImage]，页宽等于 scrollView 宽度。

// 假设 scrollView 已通过 IBOutlet 或代码创建 private let scrollView = UIScrollView() private var imageViews: [UIImageView] = [] private var currentIndex = 0 private var images: [UIImage] = [] private var timer: Timer? func setupScrollView() { scrollView.isPagingEnabled = true scrollView.showsHorizontalScrollIndicator = false scrollView.delegate = self scrollView.bounces = false // 循环滚动时关闭回弹，避免边界露白 let pageWidth = scrollView.bounds.width let pageHeight = scrollView.bounds.height // 只创建三个 imageView for i in 0..<3 { let imageView = UIImageView(frame: CGRect( x: CGFloat(i) * pageWidth, y: 0, width: pageWidth, height: pageHeight )) imageView.contentMode = .scaleAspectFill imageView.clipsToBounds = true scrollView.addSubview(imageView) imageViews.append(imageView) } // contentSize 只有三页宽 scrollView.contentSize = CGSize(width: pageWidth * 3, height: pageHeight) // 初始偏移到中间页 scrollView.contentOffset = CGPoint(x: pageWidth, y: 0) reloadImages() }

逻辑说明：三个 imageView 横向排列，contentSize 固定为三倍页宽。初始 contentOffset 设在中间页，这样左右都能滑。bounces设为 false 是因为循环滚动不需要回弹效果，回弹会让用户看到空白区域，破坏“无限”的错觉。

参数说明：pageWidth和pageHeight直接取 scrollView 的 bounds，所以这个 setup 方法必须在 layout 完成后调用，否则 bounds 为 zero，三视图会叠在一起。常见做法是在viewDidLayoutSubviews里判断如果 imageViews 为空就调用 setup，或者用 Auto Layout 约束后手动 layoutIfNeeded。

3.2 索引重映射与滚动结束处理

滚动结束的代理方法是整个循环逻辑的核心。

func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) { handleScrollEnd() } func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) { if !decelerate { handleScrollEnd() } } private func handleScrollEnd() { let pageWidth = scrollView.bounds.width let page = Int(round(scrollView.contentOffset.x / pageWidth)) if page == 0 { // 往左滑，当前索引减一 currentIndex = safeIndex(currentIndex - 1) } else if page == 2 { // 往右滑，当前索引加一 currentIndex = safeIndex(currentIndex + 1) } // page == 1 说明没动，不做处理 reloadImages() // 重置偏移到中间页，无动画 scrollView.setContentOffset(CGPoint(x: pageWidth, y: 0), animated: false) // 重启定时器 restartTimer() } private func safeIndex(_ index: Int) -> Int { guard !images.isEmpty else { return 0 } return (index + images.count) % images.count } private func reloadImages() { guard !images.isEmpty else { return } let count = images.count imageViews[0].image = images[safeIndex(currentIndex - 1)] imageViews[1].image = images[currentIndex] imageViews[2].image = images[safeIndex(currentIndex + 1)] }

逻辑说明：handleScrollEnd先根据 contentOffset 算出停靠页，0 代表左滑、2 代表右滑、1 代表没动。然后更新currentIndex，重新给三个 imageView 赋图，最后把偏移重置回中间页。注意setContentOffset的animated必须为 false，否则会触发额外的滚动动画，导致代理方法再次调用，陷入死循环。

参数说明：safeIndex里的(index + images.count) % images.count是处理负数取模的标准写法。如果图片数组为空，直接返回 0 避免崩溃。reloadImages里三个 imageView 的赋值顺序不能乱：索引 0 是前一页，索引 1 是当前页，索引 2 是后一页。

3.3 定时器自动轮播的启停控制

定时器部分需要和手势代理配合。

private func startTimer() { timer?.invalidate() timer = Timer.scheduledTimer( timeInterval: 3.0, target: self, selector: #selector(autoScroll), userInfo: nil, repeats: true ) RunLoop.current.add(timer!, forMode: .common) } @objc private func autoScroll() { let pageWidth = scrollView.bounds.width // 向右滚动一页，带动画 scrollView.setContentOffset(CGPoint(x: pageWidth * 2, y: 0), animated: true) // 注意：这里不直接更新 currentIndex，等滚动结束代理里统一处理 } func scrollViewWillBeginDragging(_ scrollView: UIScrollView) { timer?.invalidate() timer = nil } func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) { if !decelerate { restartTimer() } } func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) { restartTimer() } private func restartTimer() { timer?.invalidate() startTimer() }

逻辑说明：autoScroll把 contentOffset 设到最右页，触发滚动动画。滚动结束后scrollViewDidEndDecelerating会调用handleScrollEnd，在那里统一更新索引和重排视图。这样自动轮播和手动滑动走的是同一套结束逻辑，不会出现两套状态不一致的问题。

参数说明：RunLoop.current.add(timer!, forMode: .common)这行很关键。默认的scheduledTimer只加到.default模式，当用户按住 scrollView 时 RunLoop 切换到.tracking模式，定时器会被暂停。加到.common模式后，无论用户是否在滑动，定时器都能触发——但前面已经在scrollViewWillBeginDragging里手动暂停了，所以不会打架。timeInterval按需调整，常见 2 到 5 秒。

4. 避坑排查：循环轮播最容易翻车的五个地方

4.1 快速滑动时白屏或图片错位

现象：手指快速连续滑动，偶尔看到空白页或者图片和索引对不上。原因：handleScrollEnd里的page计算依赖round(contentOffset.x / pageWidth)，如果滑动速度极快，UIScrollView 可能一次跨过两页，page算出 3 或 -1，而代码只处理了 0、1、2 三种情况。解决：在handleScrollEnd里对page做钳制，let clampedPage = max(0, min(2, page))，然后用 clampedPage 判断方向。另外可以在scrollViewDidScroll里加一个保护，如果 contentOffset 超出三页范围就立即重置到中间页。

4.2 定时器与手动滑动冲突导致连续翻页

现象：用户手动滑了一下，松手后自动轮播连续翻了两页甚至三页。原因：scrollViewDidEndDragging和scrollViewDidEndDecelerating可能都被调用，restartTimer执行了两次，创建了两个定时器。解决：在startTimer里先timer?.invalidate()再创建新的，保证同一时间只有一个定时器实例。另外在scrollViewWillBeginDragging里把 timer 置 nil，避免野指针。

4.3 图片数量为 1 或 0 时的边界崩溃

现象：传入空数组时崩溃在images[currentIndex]，传入单张图片时循环逻辑失效。原因：safeIndex虽然处理了取模，但reloadImages里直接访问images[currentIndex]，如果数组为空就越界。解决：在reloadImages开头加guard !images.isEmpty else { return }，并且在 setup 里判断如果图片少于 2 张，直接隐藏 scrollView 或禁用滚动。单张图片时三视图显示同一张图，循环逻辑仍然成立，但自动轮播没有意义，可以在startTimer里判断images.count > 1才启动。

4.4 contentOffset 重置时的闪烁问题

现象：滚动结束重置到中间页时，屏幕闪一下。原因：setContentOffset(animated: false)是瞬间跳转，如果此时三视图的图片还没渲染完成，会有一帧空白。解决：在reloadImages之后调用scrollView.layoutIfNeeded()强制布局，确保图片赋值生效后再重置偏移。另外可以把reloadImages和setContentOffset包在UIView.performWithoutAnimation里，避免隐式动画。

4.5 内存警告时图片未释放

现象：轮播图较多时收到内存警告，App 被系统杀掉。原因：images数组持有所有 UIImage，如果图片是大图，内存占用很高。解决：不要把原图直接塞进数组，先缩放到屏幕尺寸再存。常见做法是用UIGraphicsBeginImageContextWithOptions或UIGraphicsImageRenderer生成缩略图。另外在didReceiveMemoryWarning里可以把非当前页的 imageView.image 置 nil，滚动时再按需加载。

5. 进阶技巧：用 CADisplayLink 替代 Timer 做精准帧同步

Timer 的精度受 RunLoop 模式影响，虽然加到.common能缓解，但在某些场景下仍有毫秒级偏差。如果轮播动画要求更平滑，可以用CADisplayLink替代。CADisplayLink与屏幕刷新率同步，默认 60fps，适合做逐帧动画。但用于轮播时要注意：不能直接在回调里翻页，而是累计时间，达到间隔后再触发滚动。

private var displayLink: CADisplayLink? private var accumulatedTime: CFTimeInterval = 0 private let scrollInterval: CFTimeInterval = 3.0 private func startDisplayLink() { displayLink?.invalidate() accumulatedTime = 0 displayLink = CADisplayLink(target: self, selector: #selector(handleDisplayLink)) displayLink?.add(to: .current, forMode: .common) } @objc private func handleDisplayLink(_ link: CADisplayLink) { accumulatedTime += link.duration if accumulatedTime >= scrollInterval { accumulatedTime = 0 autoScroll() } }

逻辑说明：CADisplayLink每次屏幕刷新回调一次，link.duration是上一帧到这一帧的时间间隔。累加到scrollInterval后触发翻页，然后清零重新累计。这样即使某一帧掉帧，累计时间仍然准确，不会像 Timer 那样因为 RunLoop 阻塞而漂移。

参数说明：scrollInterval设为 3.0 秒，和 Timer 方案保持一致。add(to: .current, forMode: .common)同样是为了在滚动过程中保持回调。注意CADisplayLink会强引用 target，必须在deinit或viewDidDisappear里调用invalidate()，否则会造成循环引用和内存泄漏。

验证方法：在handleDisplayLink里打印link.timestamp和link.targetTimestamp，观察帧间隔是否稳定在 16.67ms 左右。如果波动超过 5ms，说明主线程有耗时操作，需要排查其他代码。

从那以后我每次做轮播都会先问三个问题：图片数量会不会变、内存预算多少、要不要支持手动滑动时暂停自动播放。这三个答案决定了用三视图复用还是其他方案。希望帮到你。

本文还有配套的精品资源，点击获取