AXPhotoViewer 性能优化：预取机制与内存管理如何支撑千图流畅浏览

【免费下载链接】AXPhotoViewerAn iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.项目地址: https://gitcode.com/gh_mirrors/ax/AXPhotoViewer

在 iOS 开发中，图片浏览器是最容易踩性能坑的组件之一：图片加载慢、滑动卡顿、内存暴涨导致崩溃，几乎是每个开发者的噩梦。而AXPhotoViewer作为一款开源的 iOS/tvOS 相册浏览框架，凭借其精心设计的预取机制（Prefetch）与内存管理策略，即便面对上千张高清图片，依然能保持流畅的滑动体验。本文将深入源码，为你拆解 AXPhotoViewer 性能优化的核心实现，并给出可直接借鉴的优化思路。

什么是 AXPhotoViewer 预取机制？

预取（Prefetch）的核心思想很简单：在用户看到某张图片之前，提前把它下载并缓存好，这样翻页时图片已经就绪，无需等待网络请求。AXPhotoViewer 将这一思想发挥到了极致，通过一个可配置的枚举值精确控制预取力度。

三种预取策略：conservative、regular 与 aggressive

在 AXPhotosDataSource.swift 中，框架定义了三种预取行为：

• conservative（保守）：只加载当前图片，内存占用最低，但翻页时可能有等待感；
• regular（常规，默认）：加载当前页、上一页、下一页共 3 张图，兼顾流畅与内存；
• aggressive（激进）：向前后各预取 2 张，共 5 张图片，滑动几乎零等待，适合网络差或大图场景。

let dataSource = AXPhotosDataSource(photos: photos, prefetchBehavior: .aggressive)

一行代码即可切换预取力度，这正是 AXPhotoViewer 性能优化的友好之处。

预取如何执行？看 loadPhotos 的源码实现

预取并不是简单地一次性把所有图片塞进内存，而是跟随当前页索引动态调整。在 AXPhotosViewController.swift 的loadPhotos(at:)方法中：

1. 根据prefetchBehavior的数值算出要预取的图片数量；
2. 以当前索引为中心，向两侧扩展出预取范围；
3. 只对处于notLoaded（未加载）或loadingCancelled（已取消）状态的图片发起下载，避免重复请求。

同时，该方法在pageViewController(_:willTransitionTo:)翻页开始前就会被调用，也就是说用户手指还没松开，下一张图已经开始下载了。

AXPhotoViewer 内存管理：只留"看得见"的图片

预取解决"不够快"，内存管理解决"装不下"。上千张高清图片若全部驻留内存，iPhone 会直接闪退。AXPhotoViewer 的思路是：只保留当前页附近的图片，远处的一律回收。

滑走即释放：reduceMemoryForPhotos

在 AXPhotosViewController.swift 的reduceMemoryForPhotos(at:)中，翻页动画一结束（didFinishAnimating回调），框架立刻执行清理：

• 对仍在加载的远处图片：调用cancelLoad取消下载，状态标记为loadingCancelled；
• 对已加载的远处图片：将image、imageData、animatedImage全部置空，状态复位为notLoaded，下次滑回来时重新加载。

这就是"滑走即释放"的回收策略，也是 AXPhotoViewer 内存管理最核心的一环。

内存警告兜底：didReceiveMemoryWarning

即使有回收机制，极端场景下内存仍可能吃紧。AXPhotoViewer 重写了didReceiveMemoryWarning（见 AXPhotosViewController.swift），收到系统内存警告时：

1. 清空所有被回收的AXPhotoViewController，释放其持有的视图资源；
2. 对当前页之外的照片执行降级清理，只保留正在展示的一张。

双保险之下，AXPhotoViewer 的峰值内存被严格控制在"当前页 + 少量预取"的范围内。

控制器复用：翻页不卡顿的另一大秘诀

除了图片内存，视图控制器本身也是内存大户。上千页如果每页都新建一个AXPhotoViewController，内存必然爆炸。AXPhotoViewer 采用池化复用方案（见 AXPhotosViewController.swift）：

• makePhotoViewController(for:)优先从recycledViewControllers池中取出旧控制器，调用prepareForReuse()清空图片后复用；
• 只有当池为空时才新建控制器；
• 页面滑出屏幕后，通过 KVO 生命周期观察自动回收进池子。

这和 UITableView / UICollectionView 的 cell 复用如出一辙，让 AXPhotoViewer 用极少的控制器实例撑起海量图片。

网络层优化：可插拔的加载与取消

预取和回收都离不开网络层的配合。AXPhotoViewer 定义了轻量的 AXNetworkIntegrationProtocol.swift，只包含三个方法：loadPhoto、cancelLoad、cancelAllLoads。

这套协议的价值在于可插拔：默认的 SimpleNetworkIntegration.swift 基于 URLSession 实现，自带下载进度回调；也可以无缝替换为 SDWebImage、Kingfisher、Nuke 等成熟库（如 SDWebImageIntegration.swift），直接享受它们的内存/磁盘缓存能力。

关键细节在于：取消预取任务必须真的取消，否则网络请求会白白消耗带宽。AXPhotoViewer 用NSMapTable维护"图片 → 下载任务"的映射，cancelLoad时精准取消对应任务，绝不浪费资源。

图片加载状态机：避免重复加载的"大脑"

所有优化能协调运转，靠的是一套轻量状态机。在 AXPhotoProtocol+Internal.swift 中，每张图片拥有五种状态：

• notLoaded（未加载）→loading（加载中）→loaded（已加载）；
• 加载中被打断 →loadingCancelled（已取消）；
• 网络失败 →loadingFailed（失败，可点击重试）。

预取逻辑只对notLoaded/loadingCancelled状态发起请求，状态机从根源上杜绝了重复下载；失败后用户点击重试，框架会清除错误状态重新加载（见 AXPhotosViewController.swift）。

性能优化配置建议：按场景选择预取力度

了解了原理，最后给出一份可直接落地的 AXPhotoViewer 性能优化配置建议：

另外，通过 AXPagingConfig.swift 还可以设置横向/纵向翻页方向与图片间距，配合预取策略，让 AXPhotoViewer 的性能优化做到"按需定制"。

总结

AXPhotoViewer 的性能优化并非单一技巧，而是一套组合拳：动态预取保证图片提前就位，滑走即释放控制内存峰值，控制器复用降低对象开销，状态机 + 可取消网络层杜绝重复下载。理解这套设计，你不仅能用好 AXPhotoViewer，更能把同样的思路迁移到自己的 iOS 图片浏览组件中——千图流畅，从来不是玄学。

【免费下载链接】AXPhotoViewerAn iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.项目地址: https://gitcode.com/gh_mirrors/ax/AXPhotoViewer