Swift中使用NSMetadataQuery实现Spotlight搜索遇问题求助

问题诊断 #

1. 谓词匹配逻辑错误：你使用的==[cd]是精确匹配规则，只有当文件名与搜索词完全一致时才会返回结果，若无匹配项，可能导致你误以为通知未触发（实际上即使无结果，NSMetadataQueryDidFinishGathering仍会触发）。
2. 潜在引用问题：若FileSearcher实例未被强引用持有，会导致通知观察者失效，需确保单例实例始终存活。

修正后的代码 #

以下代码调整了谓词实现模糊搜索，同时优化了通知处理逻辑（避免循环引用、结果解析）：

import Foundation

let nf = NotificationCenter.default

class FileSearcher {

    public static let sharedInstance = FileSearcher()
    
    var query: NSMetadataQuery? {
        willSet {
            if let q = self.query {
                q.stop()
            }
        }
    }

    private init() {
        print("Setting observer")
        nf.addObserver(forName: .NSMetadataQueryDidStartGathering, object: nil, queue: .main) { _ in
            print("Query did start gathering")
        }

        nf.addObserver(forName: .NSMetadataQueryDidUpdate, object: nil, queue: .main) { [weak self] _ in
            print("Query results updated \(self?.query?.resultCount ?? 0)")
        }
        
        nf.addObserver(forName: .NSMetadataQueryDidFinishGathering, object: nil, queue: .main) { [weak self] _ in
            guard let results = self?.query?.results as? [NSMetadataItem] else {
                print("No results")
                return
            }
            print("Got \(results.count) results:")
            results.forEach { item in
                if let fileName = item.value(forAttribute: NSMetadataItemFSNameKey) as? String,
                   let fileURL = item.value(forAttribute: NSMetadataItemURLKey) as? URL {
                    print("- \(fileName): \(fileURL.path)")
                }
            }
        }
    }


    func searchFile(_ searchTerm: String) {
        print("Searching for: \(searchTerm)")
        query = NSMetadataQuery()
        
        // 方案1：文件名包含匹配（忽略大小写/重音）
        let predicate = NSPredicate(format: "%K CONTAINS[cd] %@", NSMetadataItemFSNameKey, searchTerm)
        
        // 方案2：文件名前缀匹配（更贴近Spotlight默认行为）
        // let predicate = NSPredicate(format: "%K LIKE[cd] %@", NSMetadataItemFSNameKey, "\(searchTerm)*")
        
        // 方案3：全文搜索（匹配文件名+文件内容/元数据）
        // let predicate = NSPredicate(format: "%K CONTAINS[cd] %@", NSMetadataQueryStringKey, searchTerm)
        
        query?.searchScopes = [NSMetadataQueryIndexedLocalComputerScope]
        query?.predicate = predicate
        query?.start()
    }
}

关键优化点 #

• 模糊搜索实现：提供3种常用匹配方案，可根据需求选择：
  • CONTAINS[cd]：匹配文件名任意位置包含搜索词的文件，cd标识忽略大小写和重音。
  • LIKE[cd] + 通配符：实现前缀/后缀/全匹配，例如\(searchTerm)*匹配前缀。
  • NSMetadataQueryStringKey：调用Spotlight的全文搜索能力，覆盖文件内容和元数据。
• 避免循环引用：在通知闭包中使用[weak self]，防止内存泄漏。
• 结果解析：将results转为NSMetadataItem数组，方便提取文件名和路径信息。

额外注意事项 #

• 文件访问权限：若需搜索用户私有目录（如Documents、Downloads），需在Info.plist中添加对应的权限描述（如NSDocumentsFolderUsageDescription），否则会被系统限制访问。
• 通知精准性：可在添加观察者时指定object为当前query，避免接收其他无关query的通知，进一步优化逻辑。

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