咨询获取macOS Finder文件预览图的API或实现方法

我之前也碰到过一模一样的问题——Finder里那些RAW文件的预览图，用常规的图标API根本拿不到，后来才搞明白这玩意儿是靠Quick Look服务生成的，给你分享下靠谱的解决办法：

• 核心思路：用Quick Look官方API
  Finder的「显示图标预览」功能本质是基于系统的Quick Look服务实现的，所以别再找普通的图标获取接口了（比如NSWorkspace的icon(forFile:)只能拿到通用文档图标），直接用Quick Look专门的缩略图生成API才是正解。

• 具体实现（Swift示例）
  推荐用QLThumbnailGenerator这个类，它是苹果官方提供的、用来生成文件Quick Look缩略图的工具，完美支持RAW图像、PDF、文档等多种类型，生成的预览图和Finder里显示的完全一致。示例代码如下：

  import QuickLookThumbnailing
  
  func generateFilePreview(for fileURL: URL, targetSize: CGSize) async throws -> CGImage {
      // 构建缩略图请求，指定文件路径、尺寸、缩放比例
      let previewRequest = QLThumbnailGenerator.Request(
          fileAt: fileURL,
          size: targetSize,
          scale: NSScreen.main?.backingScaleFactor ?? 1.0,
          representationTypes: .thumbnail
      )
      
      // 生成预览图
      let generator = QLThumbnailGenerator.shared
      let thumbnailRepresentation = try await generator.generateBestRepresentation(for: previewRequest)
      
      guard let previewImage = thumbnailRepresentation.cgImage else {
          throw NSError(domain: "PreviewGenerationError", code: -1, userInfo: [NSLocalizedDescriptionKey: "Failed to retrieve preview image"])
      }
      
      return previewImage
  }
  

• 几个关键注意点

  • 权限问题：如果是沙箱应用，必须配置对应的文件访问权限（比如通过NSOpenPanel获取用户授权的文件URL），否则API会返回权限错误
  • 格式支持：RAW格式的预览依赖系统自带的Quick Look插件，新版macOS都默认支持，无需额外安装
  • 环境兼容：QLThumbnailGenerator支持macOS 10.15及以上版本，在AppKit、SwiftUI应用里都能正常使用

• 不推荐的缓存提取方式
  你可能会发现系统把预览图缓存到~/Library/Caches/com.apple.QuickLook.thumbnailcache目录，但这个缓存的结构是苹果私有的，没有公开规范，而且会被系统定期清理，稳定性完全没法保证，强烈建议用官方API而不是直接读缓存。

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