用 find 限深搜索更可靠，因 finder 深层搜索易卡死或返回空；mdfind 依赖 spotlight 索引，未索引则静默失败；先 tree 或 ls -u 探路再操作；符号链接可简化深层路径；需排除 time machine 和 apfs 快照目录。

用 find 限深搜索，别信 Finder 的“正在搜索…”

Finder 图形化搜索在目录超过 6 层、子目录总数过万时，经常卡死或超时返回空结果——它底层依赖 Spotlight 索引，而索引对深层路径更新滞后，实际执行时会 fallback 到同步遍历，阻塞 UI。

• 直接终端执行：find /path/to/project -maxdepth 4 -name "config.json"，-maxdepth 是关键，不加就可能钻进 node_modules/.git/.gradle 这类深渊目录
• 如果要匹配文件名含通配符，用单引号避免 shell 展开：find ~/src -maxdepth 5 -name '*.pyc'
• 注意：Finder 的“种类”“大小”等筛选字段在深层路径下基本失效，别浪费时间点选

用 mdfind 走索引通道，但得先确认它真索引了

mdfind 快，是因为它查的是已建好的 Spotlight 数据库，不是实时扫盘。但如果你刚新建了一个嵌套很深的项目文件夹，Spotlight 可能根本没碰过它——这时 mdfind 就会安静地返回空，连提示都没有。

• 先检查是否被索引：mdutil -s /path/to/folder，若输出 Indexing disabled，说明该路径在 Spotlight 隐私列表里，或存在 .metadata_never_index 文件
• 快速触发重索引：打开「系统设置 → Siri 与 Spotlight → Spotlight 隐私」，把目标文件夹拖进去再立刻移出（不用点减号），Spotlight 会强制重新扫描该路径
• 搜文件名更稳：mdfind -onlyin ~/work "kMDItemDisplayName == 'build.gradle'"；搜内容请换 grep -r，mdfind 不适合全文本匹配

遍历前先“探路”，用 tree 或 ls -U 快速看结构

面对一个未知深度的工程目录，盲目 find 或 du 很容易卡住。先花 1 秒看清骨架，比等 30 秒无响应强得多。

• 装个 tree（brew install tree）：tree -L 3 -d /project 只看前三层目录，一眼识别是否有异常深的分支（比如 vendor/bundle/ruby/3.2.0/gems/...）
• 纯系统命令也够用：ls -U /project | head -20（-U 关闭排序，最快列出），确认顶层有没有明显不该存在的巨量子目录
• 慎用 du -sh *：如果当前目录下有 5000 个子目录，每个都得 stat 一次，SSD 上也卡。改用 du -sh --max-depth=1 /project | sort -hr | head -10 先揪出最大的几个方向

长期高频访问？别硬扛，用符号链接砍掉层级

每次都要 cd ~/Projects/clientX/frontend/src/lib/utils/helpers？这不是操作习惯问题，是路径设计反模式。macOS 对超过 7 层的路径解析本身就有额外开销，尤其涉及自动挂载、iCloud 同步时更敏感。

• 建短链一劳永逸：ln -s ~/Projects/clientX/frontend/src/lib/utils ~/uxlib，之后所有操作直接进 ~/uxlib
• 别用相对路径软链（如 ln -s ../../..），跨设备或移动父目录后易断；一律用绝对路径 + -s
• 如果该路径常被 IDE 或脚本引用，把链接加进 ~/.zshrc 并 source，避免不同终端环境行为不一致

最常被忽略的一点：Time Machine 本地快照和 APFS 快照目录（如 .apdisk、Backups.backupdb）虽然不显眼，但一旦出现在搜索路径中，find 和 du 会默默卡死在里面。动手前先 ls -a 看一眼有没有这些名字——有就加 -prune -o 过滤掉，别让它们拖垮整个流程。