若mdls命令无输出，可能因文件未被spotlight索引、路径错误或键名拼写错误；可通过基础查询（mdls路径）、精准提取（-name指定键）、导出文本（>文件）、批量扫描（find+exec）及索引验证（mdutil）五种方法解决。
如果您需要在macOS中快速获取文件的Spotlight索引元数据，但终端中执行mdls命令后未返回预期字段或输出为空，则可能是由于文件尚未被Spotlight索引、路径错误或键名拼写不正确。以下是多种可靠方法来查看文件元数据：
一、基础查询：显示文件全部元数据
该方法用于一次性获取文件所有已被Spotlight索引的元数据属性，适用于初步排查或全面了解文件信息。Spotlight索引状态直接影响输出完整性，未索引文件将仅返回极少数基础字段（如kMDItemFSName）或完全空白。
1、点击“启动台” → “其他” → 启动“终端”。
2、在终端中输入命令：mdls /path/to/your/file，将/path/to/your/file替换为实际文件的绝对路径（例如/Users/John/Pictures/photo.jpg）。
3、按回车执行，终端将逐行列出所有可用元数据键及其值，包括kMDItemDisplayName、kMDItemContentCreationDate、kMDItemContentType等。
二、精准提取：指定单个或多个元数据键
当只需验证特定属性（如创建时间、内容类型或作者）时，此方式可避免冗长输出，提升效率并降低误读风险。若某键无值，对应行将显示(null)；若键名不存在或拼写错误，则该键不会出现在结果中。
1、在终端中输入命令：mdls -name kMDItemFSCreationDate -name kMDItemContentType /path/to/your/file。
2、可连续添加多个-name参数，支持任意组合，例如：-name kMDItemAuthor -name kMDItemLastUsedDate -name kMDItemIsUbiquitousItem。
3、确保键名严格匹配Spotlight预定义命名规范（区分大小写），常见有效键包括kMDItemKind、kMDItemURL、kMDItemTextContent。
三、持久化保存：导出元数据至文本文件
该方法适用于需比对多个文件元数据、进行脚本分析或留档审查的场景。输出为纯文本格式，可在任意文本编辑器中打开，也支持后续用grep、awk等命令行工具处理。
1、在终端中输入命令：mdls /path/to/your/file > metadata.txt。
2、若需指定保存位置，请使用绝对路径，例如：mdls /Users/John/Documents/report.pdf > /Users/John/Desktop/report_metadata.txt。
3、执行后终端无可见输出，但可在指定路径下找到生成的文本文件，文件内容与直接运行mdls命令的屏幕输出完全一致。
四、批量扫描：结合find命令遍历目录下同类文件
适用于需统一检查某一目录内所有PDF、图片或文档是否具备关键元数据（如作者、创建时间、内容类型）的运维或合规场景。每匹配一个文件即执行一次mdls查询，结果按文件顺序连续输出，无需人工干预。
1、在终端中输入命令：find /path/to/directory -name "*.jpg" -exec mdls -name kMDItemDisplayName -name kMDItemDateTimeOriginal {} \;。
2、将/path/to/directory替换为实际目录路径（如/Users/John/Downloads），*.jpg可替换为*.pdf、*.mov等扩展名模式。
3、注意-exec与\;之间必须有空格，且\;前的反斜杠不可省略，否则命令将报错。
五、辅助验证：配合mdutil检查Spotlight索引状态
当mdls返回字段严重缺失或全为空值时，应优先确认该文件或所在目录是否已被Spotlight排除索引。此方法通过系统级索引管理工具验证并可触发重新索引，是解决“无元数据输出”问题的根本性步骤。
1、在终端中输入命令：mdutil -s /path/to/directory，查看指定目录的索引启用状态（返回“Indexing enabled.”表示正常）。
2、若返回“Indexing disabled.”，则执行：sudo mdutil -i on /path/to/directory以启用索引（需管理员密码）。
3、对单个文件强制刷新索引，可先取消其父目录索引再重新启用：sudo mdutil -i off /path/to/directory && sudo mdutil -i on /path/to/directory。
