使用QuickLook展示PDF遇“无法为URL分配文件扩展名”错误求助

我之前也碰到过一模一样的问题，大概率是你构造文件URL的方式踩坑了。你现在*手动拼接路径后转成path*的做法，很容易导致URL格式不对，让QuickLook识别不出文件的扩展名。给你几个靠谱的解决步骤：

一、替换成正确的URL获取方式 #

别再手动拼接路径了，用Bundle自带的方法来获取PDF的URL才是最稳妥的，直接把这段代码替换你原来的实现：

func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
    // 直接通过Bundle获取指定目录下的PDF文件URL
    guard let pdfURL = Bundle.main.url(forResource: nodeName, withExtension: "pdf", subdirectory: "Manuals") else {
        // 这里可以根据你的需求处理文件找不到的情况，比如弹出提示或者返回默认文件
        fatalError("找不到指定的PDF文件：\(nodeName).pdf，请检查文件名和目录")
    }
    return pdfURL as QLPreviewItem
}

二、排查几个容易忽略的细节 #

• 确认文件已加入Bundle：去项目的Build Phases -> Copy Bundle Resources里看看，你的PDF文件和Manuals目录是不是已经在列表里了，没加的话拖进去就行。
• 检查文件名和变量：确保nodeName的值和PDF文件名（不带.pdf后缀）完全一致，iOS的Bundle对文件名大小写是敏感的，别因为大小写写错导致找不到文件。
• 确认目录结构：如果你的Manuals是项目里的文件夹（不是分组），要保证它的结构在Bundle里是完整的，subdirectory参数填的"Manuals"要和实际目录名完全匹配。

这样调整后，QuickLook就能正确识别PDF的扩展名，顺利展示文件了。

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