Swift开发：PDFView在.singlePage模式下缩放卡顿问题咨询

在Swift中使用PDFView的.singlePage模式时，执行缩放操作会出现卡顿现象，未设置任何特殊配置，从零创建项目即可复现该问题。相关代码如下：

func displayPDF() {
    pdfView = PDFView(frame: CGRect(x: 0, y: 0, width: view.frame.width, height: view.frame.height))

    if let pdf = Bundle.main.url(forResource: "sample_pdf", withExtension: "pdf", subdirectory: nil, localization: nil)  {

        let doc = PDFDocument(url: pdf)
        pdfView.document = doc
    }
    pdfView.displayMode = .singlePage
    view.addSubview(pdfView)
}

缩放时界面响应滞后、动画不流畅。

1. 启用硬件加速图层渲染 #

手动开启isLayerHosting，让PDFView借助Core Animation或Metal进行硬件加速渲染，显著提升缩放流畅度：

pdfView.isLayerHosting = true

2. 限制最大缩放比例 #

无限制的极端缩放会大幅增加渲染压力，设置合理的maxScaleFactor可以避免这类场景：

pdfView.maxScaleFactor = 4.0 // 根据PDF实际尺寸调整，建议设为原始尺寸的2-4倍

3. 优化渲染区域与自动缩放 #

配置displayBox限定渲染区域，配合autoScales让PDFView提前适配视图尺寸，减少缩放时的临时计算：

pdfView.autoScales = true
pdfView.displayBox = .mediaBox // 仅渲染PDF的媒体内容区域，剔除冗余空白

4. 优化PDF文档本身 #

若PDF包含大量高分辨率图片、复杂矢量图形，即使优化PDFView设置也会有性能瓶颈。可以用专业工具（如Adobe Acrobat）压缩内嵌图片、简化矢量元素，降低文档渲染负载。

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