Mac上iCloud同步文件夹新文件无法被Spotlight搜索，是因bird进程上报文件落地但mds未触发索引；需先执行killall bird和killall cloudd释放I/O锁，再通过聚焦隐私移除并重加~/Library/Mobile Documents/com~apple~CloudDocs路径精准重建索引，最后验证范围设置、保留在本地及排查损坏导入器。

Mac上iCloud同步文件夹（如“桌面”“文稿”）里的新文件迟迟不被Spotlight搜索到，是因为同步完成与索引触发之间存在断层——bird进程上报了文件落地，但mds服务没收到通知或卡在旧状态，导致这些文件实际“存在却不可搜”。

先解除同步锁，让系统真正“看见”文件

打开“终端”，依次执行：

killall bird
killall cloudd

这两条命令会强制终止iCloud同步守护进程，释放对同步目录的I/O锁定。几秒后系统自动重启它们，此时所有已落地但未索引的文件会重新触发元数据采集，为下一步索引铺平道路。

精准刷新同步文件夹索引（推荐）

这一步跳过全盘扫描，只针对 iCloud 同步路径做轻量重建，10秒内生效，且不中断其他区域索引。

进入「系统设置」→「Siri 与聚焦」→「聚焦隐私」→ 点击右下角「+」→ 导航至 【~/Library/Mobile Documents/com~apple~CloudDocs】 → 选中该路径 → 点击左侧「−」移除

注意：必须使用这个完整路径，不能用“iCloud云盘”别名或访达中的显示名称，否则无法命中真实同步根目录。

移除后立即生效，菜单栏 Spotlight 图标旁会出现“正在建立索引…”提示，3–8秒内完成。

验证并补救遗漏场景

第一步：打开任意 Finder 窗口，点击右上角搜索框，在左上方范围标识处确认已选「这台 Mac」而非「iCloud云盘」或「桌面」

第二步：若仍搜不到，可能是文件被标记为“仅存储在iCloud”，需右键该文件夹 →「显示简介」→ 在「通用」区域勾选「始终保留在本台Mac上」→ 等待进度条走完

第三步：执行终端命令 mdimport -d1 ~/Library/Mobile\ Documents/com~apple~CloudDocs，观察输出中是否出现“importer returned error”——若有，说明某个子文件夹内含损坏的 Spotlight 导入器，需逐级缩小范围排查