Python文件监控应基于操作系统事件通知机制(如inotify、ReadDirectoryChangesW),首选watchdog库;需自定义FileSystemEventHandler子类响应on_created、on_modified等事件,注意过滤临时文件和去重;轮询方案仅适用于受限环境,但存在延迟与漏检风险。

Python文件监控的核心是实时捕获文件系统事件,比如创建、修改、删除、重命名等操作。关键不在于轮询比对文件内容(低效且延迟高),而应借助操作系统提供的事件通知机制,如Linux的inotify、Windows的ReadDirectoryChangesW、macOS的FSEvents——python-watchdog库正是对这些底层接口的跨平台封装,是当前最实用、稳定的选择。
用watchdog监听指定路径的变更
安装后,只需定义一个事件处理器类,继承FileSystemEventHandler,重写对应方法即可响应具体动作:
- on_modified(event):触发于文件内容被保存(含文本编辑器临时写入行为,需结合is_directory过滤)
- on_created(event):新文件或目录生成时调用
- on_deleted(event):文件或目录被移除
- on_moved(event):文件被重命名或移动(注意event.src_path和event.dest_path)
启动监听只需一行:observer.schedule(handler, path="/your/monitored/dir", recursive=True),recursive设为True可监控子目录。
避免重复触发与临时文件干扰
编辑器(如VS Code、Sublime)保存文件时,常先写临时文件再原子替换原文件,导致on_created + on_deleted或两次on_modified。解决方法:
立即学习“Python免费学习笔记(深入)”;
- 在on_modified中检查event.is_directory == False,排除目录事件
- 用os.path.splitext(event.src_path)[1]过滤掉.tmp、.swp、~等临时扩展名
- 加入简单去重逻辑:记录最近1秒内处理过的文件路径,重复事件直接跳过
轻量级替代方案:轮询检测(仅限简单场景)
若无法安装第三方库或目标环境受限(如某些嵌入式Python),可用os.stat()定期读取文件的st_mtime(最后修改时间)或st_size(大小)变化:
- 维护一个字典{filepath: (mtime, size)}作为快照
- 每2–5秒遍历目标目录,对比当前stat信息与快照差异
- 发现st_mtime更新即判定为变更,适合小目录、低频变更场景
注意:该方式CPU占用略高,且存在“漏检”窗口(两次轮询之间发生的快速改写+还原)。
生产环境建议:加日志、异常防护与优雅退出
真实使用中需增强健壮性:
- 用logging模块记录每次事件,便于排查误触发或权限问题
- 在事件处理函数中包裹try...except,防止单个文件解析失败中断整个监听
- 监听启动后监听KeyboardInterrupt或signal.SIGINT,调用observer.stop()和observer.join()确保资源释放










