如何通过.quickLookPreview打开存储中获取的文件预览？

这个错误是由macOS/iOS的沙箱机制导致的：通过NSOpenPanel获取的URL自带临时沙箱访问权限，但直接存储URL字符串并重新读取后，权限会丢失，无法创建沙箱包装器访问文件。

解决核心是使用**安全书签（Security Bookmarks）**持久化文件访问权限，而非直接存储URL。

1. 保存文件时生成安全书签 #

当通过NSOpenPanel获取到合法的文件URL后，不要直接存储URL，而是生成带安全作用域的书签数据并持久化：

// 假设NSOpenPanel已获取到有效的documentURL
do {
    // 生成包含安全权限的书签数据
    let bookmarkData = try documentURL.bookmarkData(
        options: .withSecurityScope,
        includingResourceValuesForKeys: nil,
        relativeTo: nil
    )
    // 将书签数据存储到UserDefaults（可替换为Core Data等其他持久化方式）
    UserDefaults.standard.set(bookmarkData, forKey: "SavedDocumentBookmark")
} catch {
    print("生成书签失败: \(error.localizedDescription)")
}

2. 读取时从书签恢复URL并获取权限 #

从存储中取出书签数据，恢复URL并启用安全作用域访问：

func restoreDocumentURL() {
    guard let bookmarkData = UserDefaults.standard.data(forKey: "SavedDocumentBookmark") else {
        return
    }
    
    var isBookmarkStale = false
    do {
        // 从书签数据恢复URL
        let restoredURL = try URL(
            resolvingBookmarkData: bookmarkData,
            options: .withSecurityScope,
            relativeTo: nil,
            bookmarkDataIsStale: &isBookmarkStale
        )
        
        // 如果书签已过期（比如文件被移动/重命名），重新生成并存储新书签
        if isBookmarkStale {
            let newBookmarkData = try restoredURL.bookmarkData(
                options: .withSecurityScope,
                includingResourceValuesForKeys: nil,
                relativeTo: nil
            )
            UserDefaults.standard.set(newBookmarkData, forKey: "SavedDocumentBookmark")
        }
        
        // 启用安全作用域，获取文件访问权限
        if restoredURL.startAccessingSecurityScopedResource() {
            documentURL = restoredURL
            // 注意：使用完文件后，务必调用stopAccessingSecurityScopedResource()释放权限
        } else {
            print("无法启用安全作用域访问")
        }
    } catch {
        print("恢复URL失败: \(error.localizedDescription)")
    }
}

3. 释放权限（重要） #

使用完文件后，必须调用stopAccessingSecurityScopedResource()释放沙箱权限，避免资源泄漏：

// 示例：在ObservableObject的deinit中释放
deinit {
    documentURL?.stopAccessingSecurityScopedResource()
}

// 或在SwiftUI View的onDisappear中处理
.onDisappear {
    documentURL?.stopAccessingSecurityScopedResource()
}

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