Swift中如何系统化管理大量文件URL书签以实现复用？

针对你需要管理大量文件书签的场景，下面几个方案比数字编号+UserDefaults的方式更清晰、可维护：

1. 用结构化文件存储书签元数据（推荐） #

创建一个可序列化的结构体记录每个书签的关键信息，把所有书签信息存在单独的plist/JSON文件里，代替UserDefaults存数量的方式。这样能直接遍历列表管理所有书签，还能附加原文件名、添加时间等元数据方便查找。

步骤示例： #

首先定义符合Codable的结构体：

struct BookmarkRecord: Codable {
    let id: String // 唯一标识，用UUID生成
    let originalFileName: String
    let bookmarkFileName: String // 对应Documents里的书签文件名
    let createdAt: Date
}

新增保存/读取记录列表的函数：

// 保存书签记录列表
func saveBookmarkRecords(_ records: [BookmarkRecord]) {
    guard let docDir = getAppDocumentDirectory() else { return }
    let recordsURL = docDir.appendingPathComponent("bookmarkRecords.json")
    do {
        let data = try JSONEncoder().encode(records)
        try data.write(to: recordsURL)
    } catch {
        print("保存记录失败：\(error.localizedDescription)")
    }
}

// 读取书签记录列表
func loadBookmarkRecords() -> [BookmarkRecord] {
    guard let docDir = getAppDocumentDirectory() else { return [] }
    let recordsURL = docDir.appendingPathComponent("bookmarkRecords.json")
    guard FileManager.default.fileExists(atPath: recordsURL.path) else { return [] }
    do {
        let data = try Data(contentsOf: recordsURL)
        return try JSONDecoder().decode([BookmarkRecord].self, from: data)
    } catch {
        print("读取记录失败：\(error.localizedDescription)")
        return []
    }
}

使用方式： #

保存新书签时：

func addNewBookmark(for url: URL) {
    let bookmarkID = UUID().uuidString
    let bookmarkFileName = "bookmark_\(bookmarkID)"
    
    // 调用你原有的saveBookmark函数
    saveBookmark(url: url, for: bookmarkFileName)
    
    // 更新记录列表
    var existingRecords = loadBookmarkRecords()
    let newRecord = BookmarkRecord(
        id: bookmarkID,
        originalFileName: url.lastPathComponent,
        bookmarkFileName: bookmarkFileName,
        createdAt: Date()
    )
    existingRecords.append(newRecord)
    saveBookmarkRecords(existingRecords)
}

读取所有书签时：

func loadAllBookmarks(completion: ([URL]) -> Void) {
    let records = loadBookmarkRecords()
    var urls: [URL] = []
    
    for record in records {
        readBookmark(for: record.bookmarkFileName) { url in
            urls.append(url)
            if urls.count == records.count {
                completion(urls)
            }
        }
    }
}

2. 把所有书签数据存在单个文件中 #

如果不想为每个书签单独生成文件，可以把所有书签的Data存在一个字典里，用UUID或处理后的文件名做key，直接保存字典的序列化数据。这样管理更集中，减少文件数量。

示例代码： #

// 保存所有书签到单个文件
func saveAllBookmarks(_ bookmarks: [String: Data]) {
    guard let docDir = getAppDocumentDirectory() else { return }
    let bookmarksURL = docDir.appendingPathComponent("allBookmarks.plist")
    do {
        let data = try PropertyListEncoder().encode(bookmarks)
        try data.write(to: bookmarksURL)
    } catch {
        print("保存所有书签失败：\(error.localizedDescription)")
    }
}

// 读取所有书签
func loadAllBookmarks() -> [String: Data] {
    guard let docDir = getAppDocumentDirectory() else { return [:] }
    let bookmarksURL = docDir.appendingPathComponent("allBookmarks.plist")
    guard FileManager.default.fileExists(atPath: bookmarksURL.path) else { return [:] }
    do {
        let data = try Data(contentsOf: bookmarksURL)
        return try PropertyListDecoder().decode([String: Data].self, from: data)
    } catch {
        print("读取所有书签失败：\(error.localizedDescription)")
        return [:]
    }
}

使用方式： #

保存新书签时：

func addNewBookmark(toAll url: URL) {
    guard url.startAccessingSecurityScopedResource() else { return }
    defer { url.stopAccessingSecurityScopedResource() }
    
    do {
        let bookmarkData = try url.bookmarkData(options: .minimalBookmark, includingResourceValuesForKeys: nil, relativeTo: nil)
        var allBookmarks = loadAllBookmarks()
        let key = UUID().uuidString // 用UUID避免重复
        allBookmarks[key] = bookmarkData
        saveAllBookmarks(allBookmarks)
    } catch {
        print(error.localizedDescription)
    }
}

读取所有书签时：

func resolveAllBookmarks(completion: ([URL]) -> Void) {
    let allBookmarks = loadAllBookmarks()
    var resolvedURLs: [URL] = []
    
    for (_, data) in allBookmarks {
        var isStale = false
        do {
            let url = try URL(resolvingBookmarkData: data, bookmarkDataIsStale: &isStale)
            if !isStale {
                resolvedURLs.append(url)
            }
        } catch {
            print("解析书签失败：\(error.localizedDescription)")
        }
    }
    completion(resolvedURLs)
}

3. 优化点补充 #

• 处理重复文件名：如果用户选择同名文件，可以在记录里添加文件创建时间或哈希值来区分，避免混淆。
• 清理无效书签：定期检查书签是否过期（stale），或原文件是否存在，及时移除无效书签。
• 批量操作支持：导入大量文件时，批量生成书签记录并一次性保存，提升性能。

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