097、watchdog 文件监控：实时监听变化、防抖处理、与任务队列的联动

097、watchdog 文件监控：实时监听变化、防抖处理、与任务队列的联动从一次线上事故说起去年维护一个自动化部署系统，用户上传配置文件后，服务端需要实时解析并更新内存中的配置。最初用os.path.getmtime轮询，每5秒扫一次目录。上线第三天，运维反馈：用户连续保存了三次配置文件，系统却只响应了最后一次，而且中间两次的变更日志全丢了。排查发现，编辑器保存文件时，会先写入临时文件再重命名，或者触发多次modified事件。轮询模式根本扛不住这种高频、非原子性的写入。更坑的是，某些编辑器（比如 Vim）保存时会先删除原文件再创建新文件，导致os.path.exists在轮询间隙返回False，直接跳过处理。这就是典型的文件监控场景：你需要实时感知变化，但又不能对每一次微小波动都做出反应。watchdog 就是干这个的。watchdog 的核心：事件驱动的文件系统观察者watchdog 底层依赖操作系统提供的文件系统事件通知机制——Linux 上的 inotify、macOS 上的 FSEvents、Windows 上的 ReadDirectoryChangesW。它不轮询，而是注册回调，事件发生时主动通知你。安装很简单：pipins