mdfind命令可高效精准搜索mac文件：一、模糊搜关键词；二、-name限定文件名；三、用kmditemcontenttype按类型筛选；四、-onlyin限制目录；五、用&&、||、!组合布尔逻辑。
如果您需要在Mac上快速定位文件，但Finder搜索响应缓慢或结果不精准，则可能是由于未调用Spotlight底层索引机制。以下是使用mdfind命令搜索文件的多种方法：
一、按文件名关键词模糊搜索
mdfind默认对文件名、内容及元数据进行全文索引匹配，输入任意关键词即可返回所有相关条目，无需指定路径，响应为毫秒级。
1、打开“终端”应用（位于“应用程序 > 实用工具”中）。
2、输入mdfind后紧跟英文双引号包裹的关键词，例如：mdfind "发票"。
3、按下回车键，终端立即列出所有文件名或内容中包含“发票”的文件完整路径。
二、限定仅匹配文件名
当需排除内容匹配干扰、确保结果严格基于文件名时，应使用-name参数强制约束搜索维度，避免误命中含关键词的文档正文。
1、在终端中执行命令：mdfind -name "项目计划"。
2、该命令将只返回文件名中出现“项目计划”的项，忽略内容含该词的其他PDF或文本文件。
三、按文件类型精确筛选
利用macOS元数据属性（kMDItemContentType）可直接按系统定义的统一类型标识符过滤，比扩展名更可靠，能覆盖无扩展名或扩展名被修改的文件。
1、搜索所有PDF文件：输入mdfind 'kMDItemContentType == "com.adobe.pdf"'。
一款AI工具，主要用于使用 CodexBar CLI 本地成本使用情况，按模型汇总 Codex 或 Claude 的使用量，包括当前（最新）模型或完整的模型分解，适合需要提升相关任务效率的用户。
2、搜索所有图像文件：输入mdfind 'kMDItemContentTypeTree == "public.image"'。
3、搜索纯文本文件（不含富文本、代码、日志等）：输入mdfind 'kMDItemContentType == "public.plain-text"'。
四、限制搜索作用域至指定目录
全盘索引虽快，但可能返回大量无关路径；添加-onlyin参数可将扫描范围锁定在用户可控目录内，提升结果相关性并规避系统目录权限拒绝错误。
1、仅在“文档”文件夹中搜索：输入mdfind -onlyin ~/Documents "会议纪要"。
2、仅在桌面查找截图类文件：输入mdfind -onlyin ~/Desktop "截图"。
3、在下载目录中查找最近的ZIP包：输入mdfind -onlyin ~/Downloads -name "*.zip"。
五、组合条件进行布尔逻辑检索
通过&&（且）、||（或）、!（非）等运算符连接多个元数据谓词，可在单次查询中实现多维交叉过滤，替代多次手动筛选。
1、查找名称含“报告”且为PDF类型的文件：输入mdfind 'kMDItemDisplayName == "*报告*" && kMDItemContentType == "com.adobe.pdf"'。
2、查找内容含“API_KEY”但非JavaScript文件：输入mdfind 'kMDItemTextContent == "*API_KEY*" && !(kMDItemContentType == "com.netscape.javascript-source")'。
3、查找创建日期为今天的所有图像：输入mdfind 'kMDItemContentTypeTree == "public.image" && kMDItemFSCreationDate >= $time.today'。
