Linux用inotify监听需防fd泄漏、递归注册子目录、设IN_CLOEXEC标志、处理IN_Q_OVERFLOW；macOS用FSEvents须配CFRunLoop、校验路径、设文件事件标志；Windows用ReadDirectoryChangesW需异步IO、足够缓冲区、UNC路径及权限。
Linux下用inotify实现文件夹监听，但要注意资源泄漏风险
inotify是Linux原生方案，轻量且高效，但每个watcher会占用一个文件描述符，不及时inotify_rm_watch或close会导致fd耗尽。监听深层嵌套目录时，需递归调用inotify_add_watch，且对每个子目录单独注册——不能只监听父目录指望事件穿透到子项。
常见错误是把inotify_init1(IN_CLOEXEC)写成inotify_init()，遗漏IN_CLOEXEC标志会导致fork后子进程意外继承inotify fd；另一个坑是未处理IN_Q_OVERFLOW事件，队列满时后续事件丢失，需在读取循环中检查len == 0并重置watcher。
示例关键片段：
int fd = inotify_init1(IN_CLOEXEC); int wd = inotify_add_watch(fd, "/path", IN_CREATE | IN_DELETE | IN_MOVED_TO); // ……读取event时必须循环read直到返回0或EAGAIN
macOS用FSEvents API，必须用CFRunLoop配合，否则事件不触发
FSEvents不是纯C接口，它依赖Core Foundation的运行循环机制。直接裸调FSEventStreamCreate后不启动CFRunLoopRun()，或者在非主线程调用却没手动创建CFRunLoop，都会导致回调函数永不执行。
立即学习“C++免费学习笔记（深入）”；
路径参数必须传绝对路径，且需用CFStringCreateWithCString转CFString；监听数组里如果混入不存在的路径，FSEventStreamScheduleWithRunLoop会静默失败——建议先用access()校验路径可读性。事件类型默认不过滤，若只关心修改，需在FSEventStreamCreate的flags参数中设kFSEventStreamCreateFlagFileEvents，否则只收到目录级事件。
注意：FSEvents对硬链接、符号链接行为不一致，INODE变化类事件（如rename）可能触发两次，需在回调里用getpid()或时间戳去重。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
Windows用ReadDirectoryChangesW，必须用Overlapped I/O避免阻塞主线程
ReadDirectoryChangesW是同步阻塞调用，若直接在主线程循环调用，整个程序会卡死。正确做法是开独立线程+OVERLAPPED结构+WaitForSingleObject等待完成事件，或更推荐用IOCP（完成端口）——但IOCP配置复杂，小项目用事件对象更稳妥。
容易被忽略的是缓冲区大小：lpBuffer必须足够大（通常≥8KB），否则ERROR_NOTIFY_ENUM_DIR错误频发；另外dwNotifyFilter要显式包含FILE_NOTIFY_CHANGE_LAST_WRITE等具体位，不能只传FILE_NOTIFY_CHANGE_ATTRIBUTES指望覆盖全部变更。
路径必须是UNC格式或驱动器根路径（如L"C:\folder"），不能用相对路径；且目标目录需有FILE_LIST_DIRECTORY权限，否则GetLastError()返回ERROR_ACCESS_DENIED而非直观提示。
跨平台封装时，别试图抽象出统一事件结构，优先隔离平台差异
各系统事件语义差异太大：Linux的inotify事件带cookie标识mv操作，macOS的FSEvents批量合并事件，Windows的ReadDirectoryChangesW每条记录只含文件名无完整路径。强行统一成enum EventType { CREATE, DELETE }会导致逻辑补丁越打越多。
实操建议是定义平台无关的回调函数签名，如void on_change(const std::string& path, ChangeKind kind)，但内部实现完全分叉：Linux解析struct inotify_event，macOS从CFArrayRef提取路径字符串，Windows用GetFileInformationByHandle补全绝对路径。构建系统用CMake按WIN32/__linux__/__APPLE__条件编译，比宏嵌套更清晰。
真正麻烦的是递归监听——Windows需手动遍历子目录逐个CreateFile再ReadDirectoryChangesW，macOS用kFSEventStreamEventFlagItemIsDir判断后递归添加，Linux则靠IN_MOVED_TO和IN_ISDIR组合推断。这部分逻辑无法复用，硬凑只会让bug更难定位。
