macOS高性能目录深度扫描需绕过Shell层，直接调用FSEvents+GCD+URL-based API；用NSFileManager enumeratorAtURL惰性枚举、批量获取元数据、跳过包/隐藏文件；结合FSEventStream实现增量监听；用fstatat等底层系统调用加速属性读取；并规避APFS快照、权限中断与符号链接陷阱。
macOS 上实现高性能目录深度扫描，关键在于绕过高开销的 Shell 层（如 find 或 mdfind），直接调用底层系统 API，并充分利用其并发与增量能力。核心是使用 libdispatch（GCD）+ FSEvents + FSRef / URL-based APIs 的组合，而非递归遍历路径字符串。
用 NSFileManager 配合 enumeratorAtURL:... 实现低开销遍历
相比 subpathsOfDirectoryAtPath:（会一次性加载全部路径字符串到内存），enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: 是流式、惰性枚举器，内存占用恒定，支持跳过特定类型（如包、符号链接、隐藏项）：
- 设置
NSDirectoryEnumerationSkipsPackageDescendants避免展开 .app/.framework 内部 - 传入
@[NSURLTotalFileAllocatedSizeKey, NSURLContentModificationDateKey]等 key，在枚举时批量获取元数据，避免后续反复 stat - 启用
NSDirectoryEnumerationSkipsHiddenFiles过滤 .DS_Store、.git 等
用 FSEventStream 替代轮询，监听变更并局部更新
全量扫描只在首次或强制刷新时执行；日常监控应基于 FSEventStreamCreate 注册目录树，接收内核级事件（create/remove/move/modified）：
- 事件流可设置
kFSEventStreamCreateFlagFileEvents获取文件级粒度，而非仅目录级 - 结合
FSEventStreamShowInfo调试事件漏报问题（注意：.DS_Store 变更默认不触发，需显式监听） - 收到事件后，仅对变动路径做增量处理（如重新哈希、更新索引），避免重复扫描整个树
用 dispatch_io 或 POSIX fstatat(AT_FDCWD, ...) 加速元数据读取
当需要快速获取大量文件属性（大小、修改时间、inode、类型）时，Objective-C/Swift 的 resourceValuesForKeys: 在深层嵌套下仍有 ObjC runtime 开销。更底层的方式包括：
- 在 GCD 并发队列中调用
fstatat(AT_FDCWD, path, &sb, AT_SYMLINK_NOFOLLOW)—— 避免路径拼接，减少字符串操作和 syscall 开销 - 对大批量文件，用
dispatch_io_create_with_path打开目录 fd 后批量读取（需配合getdirentriesattr，但该 API 已被标记为 deprecated，仅在 macOS 12+ 中仍可用且极快） - 慎用
fts_open()：虽比readdir高效，但在 APFS 上可能因克隆/快照语义导致意外行为，建议仅用于兼容场景
规避常见陷阱：APFS 快照、符号链接、权限中断
高性能 ≠ 无脑并发。实际部署需主动处理系统特性：
- APFS 快照目录（如
.DocumentRevisions-V100）会显著拖慢遍历 —— 必须在枚举选项中加入NSDirectoryEnumerationSkipsSubdirectoryDescendants并手动过滤匹配^\.[^/]+-V\d+$的目录名 - 遇到
EACCES不要立即失败：记录路径并继续，最后统一汇总权限不足项；也可用access(path, R_OK)预检，避免触发 full stat - 符号链接默认不跟随 —— 若需解析，用
NSURLFileResourceType判断后调用destinationOfSymbolicLinkAtPath:error:，但切忌无限制递归（设深度上限 32）
