Spotlight 搜索失效是因索引服务崩溃或数据库损坏，需依次执行：重启元数据服务、清理重复导入器、重建索引、检查聚焦隐私设置。
macOS 升级后聚焦搜索搜不到本地文件，不是单纯“变慢”，而是输入关键词完全无响应、不返回任何文档或应用——这大概率是索引服务崩溃或数据库结构损坏，而非设置误调。升级过程常导致元数据服务（mds、mds_stores）状态异常、导入器冲突或索引库文件（/.Spotlight-V100）底层损坏。
快速唤醒僵死的元数据服务
这是最轻量、见效最快的一步，适合刚升级完 Spotlight 突然“失联”的情况：
- 打开终端，逐行执行（每行回车一次）：
sudo killall -HUP mdssudo killall -HUP mds_storessudo launchctl kickstart -k system/com.apple.metadata.mds - 等待 5–10 秒，Spotlight 搜索框会短暂显示“正在建立索引…”
- 立即用 Command + Space 搜索一个你刚刚保存的文本文件名，若秒出结果，说明服务已恢复，无需继续下一步
检查并清理冲突的 Spotlight 导入器
系统升级后，旧版第三方软件（如 Outlook、PDF 工具、邮件客户端）可能残留多个同名导入器，导致 mds_stores 在解析某类文件时卡死或跳过：
macOS Local Voice
下载
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
- 在终端运行：
mdimport -L - 查看输出中是否出现重复项，例如：
Microsoft Outlook Spotlight Importer.mdimporter (v2.0)Microsoft Outlook Spotlight Importer.mdimporter (v1.9) - 只保留当前软件版本对应的那一项，其余全部删除（路径通常位于
/Applications/xxx.app/Contents/Library/Spotlight/） - 删完重启 Mac，让系统重新加载干净的导入器列表
强制重建本地磁盘索引
若前两步无效，说明 /.Spotlight-V100 数据库已损坏，必须从零重建：
- 关闭索引服务：
sudo mdutil -a -i off - 彻底清除现有索引：
sudo mdutil -a -E - （可选但推荐）清空缓存：
rm -rf ~/Library/Caches/com.apple.Spotlight* - 重新启用并触发重建：
sudo mdutil -a -i on - 系统将自动为所有挂载卷启动重建，可在 Spotlight 框右上角观察进度提示；小容量磁盘约需几分钟，TB 级 SSD 可能需数小时
确认 Spotlight 设置未意外排除主磁盘
升级有时会重置隐私设置，导致启动磁盘被静默加入“聚焦隐私”列表：
- 进入 系统设置 → Siri 与聚焦 → 聚焦隐私
- 检查列表中是否包含你的启动磁盘（如 “Macintosh HD” 或自定义名称）
- 如有，选中后点击“−”按钮移除
- 移除后 Spotlight 会立刻开始重新扫描，无需手动触发
