Spotlight 搜不到新文件因非实时索引，需数秒至数分钟延迟；索引状态可用 mdutil -s / 查看，禁用时需在系统设置中移除隐私排除；非原生格式卷默认不索引；路径搜索需用 folder:"" 语法且仅限已索引路径；mdfind 更精准，支持布尔逻辑与时间筛选；默认跳过隐藏文件、临时文件及权限不足项。
Spotlight 为什么搜不到你刚放进去的文件
Spotlight 不是实时索引，新文件写入后通常要等几秒到几分钟才被收录，尤其在批量拷贝或休眠唤醒后。系统会延迟处理以节省资源，不是坏了。
- 手动触发重建：终端运行
mdutil -E /（需管理员密码），但会清空现有索引并全盘重扫，耗时长、发热高，仅限索引损坏时用 - 检查索引状态：运行
mdutil -s /，返回Indexing enabled.才正常；若为Indexing disabled.，说明该卷被排除，需进「系统设置 → Siri 与 Spotlight → Spotlight 隐私」移除对应路径 - 某些挂载卷（如 NTFS、exFAT、网络盘）默认不索引，
mdutil -i on /path/to/volume可尝试启用，但 macOS 对非原生格式支持有限，成功率低
如何让 Spotlight 精准匹配某个目录下的文件名
Spotlight 原生不支持路径前缀语法（比如 path:~/Documents），但它能识别文件路径字段，配合类型和名称过滤可逼近效果。
- 在 Spotlight 搜索框输入
name:report.pdf kind:pdf，比单纯输report更快定位同名 PDF - 用
folder:"~/Documents/Projects"可筛选位于该路径下的结果（注意双引号和波浪线），但仅对已索引的路径有效，且大小写不敏感 - 避免用中文路径名直接搜索——部分版本 Spotlight 对 UTF-8 路径解析不稳定；建议用英文文件夹名，或改用
mdfind命令行工具补位
mdfind 命令比 Spotlight 图形界面更可控
mdfind 是 Spotlight 的底层命令行接口，支持布尔逻辑、路径限定和元数据字段，适合脚本或精确查找。
- 查当前目录下所有 .log 文件：
mdfind -onlyin . "kMDItemContentType == 'public.plain-text'" - 按修改时间范围筛：
mdfind -onlyin ~/Downloads 'kMDItemContentModificationDate >= $time.today(-7)'（查近 7 天） - 排除某类文件：
mdfind -onlyin . 'kMDItemDisplayName == "*.*" && NOT kMDItemDisplayName == "*.tmp"' - 注意：
mdfind不自动展开 shell 变量（如$HOME），必须写成~/或绝对路径；-onlyin后路径末尾不加斜杠，否则可能匹配失败
哪些文件类型默认不被 Spotlight 索引
不是所有文件都会进索引——系统会跳过临时文件、隐藏文件、特定扩展名及权限不足的条目。
- 默认忽略：以
.开头的文件/文件夹（如.git、.DS_Store）、~结尾的备份文件、.swp/.tmp/.part等临时扩展名 - 可通过
mdimport -X查看当前启用的导入器列表；若某类文件（如自定义 YAML 配置）没结果，大概率因无对应 importer，需第三方工具（如mdimporter-yaml）补充 - 权限问题常被忽略：如果文件属主不是当前用户，或目录权限为
700且非属主，Spotlight 可能跳过读取——ls -l看一眼归属，必要时chown或放宽chmod
