NSMetadataQuery未返回相关文件：检索结果与Finder/mdfind不符问题排查

核心问题 #

你的NSMetadataQuery返回结果异常的主要原因是文本内容匹配的谓词写法错误，导致无法正确匹配文件内的文本内容，仅能匹配文件名的部分结果还被浏览器缓存干扰。

错误点拆解 #

• 文本内容匹配谓词错误：原代码中使用kMDItemTextContent == %@并传入带通配符的*strom*，==是精确匹配逻辑，不会解析通配符，因此这个谓词无法匹配任何包含"strom"文本内容的文件。
• 通配符使用不当：即使想用通配符匹配，也应使用LIKE操作符，而非直接在精确匹配的查询字符串中加星号。

修正后的代码 #

struct SpotlightSOExample: View {
    @State private var results: [String] = []
    @State private var query: NSMetadataQuery?
    @State private var token: NSObjectProtocol?

    var body: some View {
        VStack(alignment: .leading, spacing: 8) {
            List(results, id: \.self) { path in
                Text(path)
            }
        }
        .onAppear(perform: runSearch)
    }

    private func runSearch() {
        results = []
        let query = NSMetadataQuery()
        query.searchScopes = [NSMetadataQueryUserHomeScope]
        // 修正谓词：文本内容用CONTAINS[cd]做不区分大小写的包含匹配，文件名保持原有逻辑
        query.predicate = NSCompoundPredicate(orPredicateWithSubpredicates: [
            NSPredicate(format: "kMDItemTextContent CONTAINS[cd] %@", "strom"),
            NSPredicate(format: "kMDItemDisplayName CONTAINS[cd] %@", "strom"),
        ])
        query.valueListAttributes = [NSMetadataItemPathKey]

        token = NotificationCenter.default.addObserver(
            forName: .NSMetadataQueryDidFinishGathering,
            object: query, queue: .main
        ) { [self] _ in
            if let token { NotificationCenter.default.removeObserver(token) }
            query.disableUpdates()
            self.results = query.results.compactMap {
                ($0 as? NSMetadataItem)?.value(forAttribute: NSMetadataItemPathKey) as? String
            }
            query.stop()
            self.query = nil
            self.token = nil
        }

        query.start()
        self.query = query
    }
}

额外优化建议 #

• 如果需要更灵活的通配符匹配（比如前缀/后缀精准匹配），可以改用LIKE操作符，示例：

  NSPredicate(format: "kMDItemTextContent LIKE[cd] %@", "*strom*")
  

  注：LIKE会解析通配符，CONTAINS是直接匹配子字符串，两者效果相近但实现逻辑不同。
• 若仍存在结果不全的情况，可检查：
  • Spotlight索引完整性：打开「系统设置-通用-Spotlight」，确认目标文件类型已被纳入索引；
  • 权限限制：即使关闭了App Sandbox，部分系统目录（如~/Library下的部分子目录）可能需要额外访问权限。

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