从零编写 C++ 迷你游戏引擎：跨平台文件系统监控的踩坑实录

开场当你兴致勃勃地打开编辑器，按下保存键，期待热重载的奇迹发生——结果编辑器直接崩溃，或者资源根本没更新。这一幕在从零自研引擎时几乎无法避免。最初我在 Linux 上用 inotify 跑通了文件监控，信心满满移植到 Windows，发现ReadDirectoryChangesW的行为模式完全不同；再到 macOS，FSEvents 又是一套独立 API。三套代码、三种语义、三种坑位——这不是偶然，而是三套 API 在内核里各自长在完全不同的机制上。更麻烦的是，资源管线、游戏逻辑、序列化系统全都依赖这个监听器，它吐出一个错误事件，上层一切跟着翻车。下面先讲清「为什么三个系统长得不一样」，再逐个拆坑，最后给出一套能用的抽象层设计。一、为什么三套 API 差异这么大文件监控不是"操作系统提供的标准功能"，而是各内核在不同历史背景下长出来的不同机制，理解它们的出身，才能理解行为的差异：Linux inotify：挂在 inode 上的观察点（watch）。你监视的是"这个目录这个 inode 上发生的事件"，所以它天然不递归——子目录是另一个 inode，想监视得自己挨个加 watch。事件带 cookie 字段，专门为配对 rename 设计。Windows ReadDirectoryChangesW：基于目录变更通知 + IRP（I/O Request Packet）。你提交一个缓冲区给系统，系统把变更记录填进去还给你。它天然