Swift中PDFKit的PDFThumbnailView跳页问题：无法连续显示页面

嘿，我之前也踩过类似的PDF缩略图跳页坑，这种只显示1、3、5这类奇数页的情况，大概率是你在加载或配置PDF页面时的细节没处理对，咱们一步步来排查解决：

• 检查页面遍历逻辑，别不小心跳过偶数页
  很多时候是循环遍历页面时步长设错了！PDF页面的索引是从0开始的（0对应第1页，1对应第2页），如果你的循环写了stride(from: 0, to: pageCount, by: 2)这种步长为2的逻辑，就会只取0、2、4这些索引，对应显示1、3、5页。
  错误示例：

  for pageIndex in stride(from: 0, to: pdfDocument.pageCount, by: 2) {
      let page = pdfDocument.page(at: pageIndex)
      // 添加到缩略图视图
  }
  

  改成逐个遍历所有页面：

  for pageIndex in 0..<pdfDocument.pageCount {
      guard let page = pdfDocument.page(at: pageIndex) else { continue }
      // 将页面正确添加到缩略图视图
  }
  

• 检查自定义数据源的索引返回逻辑
  如果你实现了PDFThumbnailViewDataSource协议，比如thumbnailView(_:pageAtIndex:)方法，一定要确保返回的是对应索引的页面，别搞混了索引计算。
  错误示例：

  func thumbnailView(_ thumbnailView: PDFThumbnailView, pageAtIndex index: Int) -> PDFPage? {
      // 错误：返回了翻倍的索引，导致只取奇数页
      return pdfDocument.page(at: index * 2)
  }
  

  正确写法：

  func thumbnailView(_ thumbnailView: PDFThumbnailView, pageAtIndex index: Int) -> PDFPage? {
      return pdfDocument.page(at: index)
  }
  

• 排查缩略图视图的布局设置
  有时候布局约束或视图属性设置不当，会导致偶数页被隐藏或挤出去。你可以重置下布局相关属性试试：

  thumbnailView.layoutMode = .horizontal // 根据需求选水平或垂直布局
  thumbnailView.thumbnailSize = CGSize(width: 80, height: 100) // 设置合适的缩略图尺寸
  thumbnailView.interitemSpacing = 10 // 调整缩略图之间的间距，避免重叠或被裁剪
  

• 确认PDF文档本身没问题
  先换个靠谱的PDF阅读器打开你的文档，看看所有页面是不是都能正常显示。如果文档本身偶数页就损坏或缺失，那得先修复文档再处理代码。

按这几步排查下来，基本就能解决只显示奇数页的问题啦！

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