使用PDFKit处理PDF后内部超链接丢失的原因咨询

核心原因 #

你当前的代码通过CGContext重新渲染PDF页面的视觉内容，完全丢失了原PDF的结构化交互元素：

• PDF的内部链接属于页面注解（Annotation），是独立于视觉渲染内容的结构化数据，page.draw(with:to:)方法只会绘制页面的文字、图形等视觉部分，不会复制注解、目录大纲这类非渲染结构。
• 你是从头创建一个全新的PDF文件，仅把原页面的视觉画稿导入，原PDF的元数据、链接、书签等所有非视觉结构都没有被迁移到新文件中。

解决方向 #

放弃用CGContext从头构建PDF，直接使用PDFKit的PDFDocument和PDFPage对象进行结构化操作，这样能完整保留原PDF的所有交互元素：

示例代码 #

guard let originalDoc = PDFDocument(url: input) else { return }
let newDoc = PDFDocument()

// 完整复制原文档的页面、链接、大纲等所有结构
for pageIndex in 0..<originalDoc.pageCount {
    guard let page = originalDoc.page(at: pageIndex) else { continue }
    newDoc.insert(page, at: newDoc.pageCount)
    
    // 用PDFAnnotation在页面上添加文本，避免破坏原有结构
    let textAnnotation = PDFAnnotation(bounds: drawrect, forType: .freeText, withProperties: nil)
    textAnnotation.contents = text
    textAnnotation.font = textFontAttributes[.font] as? NSFont
    textAnnotation.color = textFontAttributes[.foregroundColor] as? NSColor
    page.addAnnotation(textAnnotation)
}

// 保存修改后的文档
try? newDoc.write(to: GetOutputFileName(inputfile: x))

补充说明 #

• 这种方式基于PDFKit的原生对象操作，所有原PDF的交互元素（内部链接、目录书签、表单等）都会被完整保留，因为你是在原页面的基础上追加内容，而非重新渲染视觉层。
• 如果确实需要用CGContext做复杂渲染，那你需要手动提取原页面的所有注解（包括链接），然后在新创建的PDF中重新构建这些注解，这个过程需要解析PDF的底层注解结构，实现成本远高于直接使用PDFKit API。

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