用 mdimport 强制索引指定文件

用 mdimport 把某个文件或文件夹立即送入 Spotlight 索引,或预览它能提取到的元数据。

macOS搜索聚焦搜索mdimport 导入低风险
运行 mdimport ~/Documents/文件.pdf 立即索引该文件;用 mdimport -t -d2 文件.pdf 可只打印 Spotlight 将提取的元数据。

01命令

命令
$ mdimport -t -d2 ~/Documents/report.pages

02作用说明

mdimport 正是 Spotlight 用来把文件送入导入器插件的工具,手动调用可以强制重新导入某个路径,不必等 Spotlight 自己安排。对迟迟搜不到的文件运行它,通常马上就能被搜到,整个文件夹也适用。加 -t -d2 时文件并不会被索引,而是打印导入器提取出的全部属性(标题、作者、日期、内容摘要),这是排查某类文件为何搜不到的最快方法。

03风险

风险低风险
!注意: -t 仅用于测试:文件不会被真正加入索引,要真实索引用不带 -t 的 mdimport。没有对应导入器插件的自定义文件类型会显示很少甚至没有属性——这是插件限制,不是索引坏了。

04撤销

✓无需撤销——该命令不会改变持久状态。

05来源

  • mdimport - Spotlight importer tool
    SS64 · technical · 2026-09-17
    依据: Documents mdimport for importing a path into the Spotlight index and -t -d2 to test-print the extracted metadata.

最后验证: 2026-09-18 · 分类: 文件与文件夹

06相关方案