iOS保存最近使用(MRU)文档列表最优策略及UIDocument URL持久化

一、先解决你遇到的URL路径差异问题 #

你碰到的file:///var/...和file:///private/var/...路径不一致，说白了就是iOS里/var是/private/var的快捷方式，两个URL指向同一个物理文件夹，但字符串写法不同。直接存储URL字符串肯定会出现匹配失败的问题，更麻烦的是：应用重装后，沙盒的容器ID会变更，旧的URL字符串会直接失效。

二、靠谱的URL持久化方法：安全书签（Security Scoped Bookmarks） #

这是Apple官方推荐的持久化文件/目录引用方案，不管是应用重启、重装，还是处理iCloud/第三方共享的文档，都能保持引用有效，还能自动处理路径符号链接的差异。

1. 生成安全书签 #

针对UIDocument的fileURL生成书签数据，存储到本地（比如UserDefaults或Core Data）：

func createBookmark(for url: URL) throws -> Data {
    // 针对iCloud或外部文档，需要启用安全作用域
    let bookmarkData = try url.bookmarkData(options: .withSecurityScope,
                                           includingResourceValuesForKeys: nil,
                                           relativeTo: nil)
    return bookmarkData
}

2. 从书签恢复URL #

应用重启后，通过保存的书签数据还原URL，同时验证书签是否过期：

func resolveBookmark(_ bookmarkData: Data) throws -> URL {
    var isStale = false
    let url = try URL(resolvingBookmarkData: bookmarkData,
                     options: .withSecurityScope,
                     relativeTo: nil,
                     bookmarkDataIsStale: &isStale)
    
    // 如果书签过期，重新生成并更新本地存储
    if isStale {
        let newBookmarkData = try url.bookmarkData(options: .withSecurityScope,
                                                  includingResourceValuesForKeys: nil,
                                                  relativeTo: nil)
        // 用文件名作为唯一标识存储，可根据需求替换
        UserDefaults.standard.set(newBookmarkData, forKey: "MRU_\(url.lastPathComponent)")
    }
    
    // 安全作用域的URL，需先调用startAccessing才能操作
    if url.startAccessingSecurityScopedResource() {
        defer { url.stopAccessingSecurityScopedResource() }
        // 此处可执行文档打开、编辑等操作
    }
    
    return url
}

3. 注意事项 #

• 针对应用沙盒内的本地文档，除了书签，也可以存储相对路径：比如存相对于documentDirectory的路径，重启后拼接当前的documentDirectory URL即可。但iCloud或外部共享文档必须使用安全书签。
• 书签是二进制数据，适合存在UserDefaults、Core Data中，敏感文档建议存到Keychain。

三、MRU文档列表的最优维护策略 #

结合安全书签，MRU列表需兼顾有效性、性能和用户体验：

1. 存储结构 #

用数组存储书签数据，同时记录文档元信息（文件名、最后访问时间、缩略图等），避免每次都从URL读取。数据复杂时用Core Data存储更合适：

struct MRUItem {
    let bookmarkData: Data
    let fileName: String
    let lastAccessedDate: Date
    let thumbnail: Data? // 缓存缩略图，提升列表加载速度
}

2. 更新规则 #

• 每次打开/编辑文档时，将对应的MRU项移到列表头部；新文档直接添加到头部。
• 限制MRU列表最大数量（比如10个），超过时移除最久未访问的项。
• 应用启动时遍历MRU列表，移除无法解析的书签（比如文档已被删除）。

3. 性能优化 #

• 提前缓存文档元信息，避免每次加载MRU列表都解析书签读取文件名。
• 异步解析书签：MRU列表加载时放到后台处理，避免阻塞UI。

四、临时解决路径差异的过渡方案（不推荐长期使用） #

如果只是临时解决var和private/var的字符串差异，可以统一URL路径格式：

func normalizeURL(_ url: URL) -> URL {
    let path = url.path
    // 将/private/var替换为/var，或反过来均可
    let normalizedPath = path.replacingOccurrences(of: "/private/var", with: "/var")
    return URL(fileURLWithPath: normalizedPath)
}

但该方案无法解决应用重装后沙盒路径变更的问题，仅适合临时过渡，长期必须使用安全书签。

内容的提问来源于stack exchange，提问作者Gene Z. Ragan