Python案例怎么监控文件变化？

wen python案例 2026-06-08 34

Python文件监控实战：从入门到高效实现文件变化监听

📚 文章导读

章节	内容简介	适合人群
文件监控的应用场景	为什么需要监控文件变化？常见业务场景	所有读者
核心实现方法对比	poll、inotify、watchdog 三大方案剖析	技术选型者
实战案例一：使用watchdog库	最简单的跨平台文件监控代码	Python初学者
实战案例二：基于inotify的高性能监控	Linux下的低开销实现	中级开发者
常见问题与Q&A	踩坑经验与性能优化技巧	所有读者

文件监控的应用场景

在日常开发中,许多功能需要实时感知文件系统的变化。自动化部署工具检测到代码文件被修改后自动重启服务；日志管理系统实时读取新增日志内容并进行分析；云同步软件（如Dropbox）监听本地文件变动后上传，如果没有文件监控机制，这些场景只能依赖定时轮询（每N秒扫描一次），既浪费CPU资源，又存在延迟。

Python案例怎么监控文件变化？

核心痛点：如何用Python高效监听文件的新建、修改、删除，并立即做出响应？

核心实现方法对比

Python社区提供了多种文件监控方案,以下是主流三种的对比：

方案	底层原理	跨平台性	性能	推荐场景
poll	轮询文件状态	✅ 所有平台	差（CPU消耗高）	几乎不推荐
inotify	Linux内核事件机制	❌ 仅Linux	极优	生产环境专用
watchdog	包装多种底层API	✅ Win/Mac/Linux	优秀	跨平台首选

注意：Windows下可使用ReadDirectoryChangesW，macOS下使用kqueue，但最简洁的方式是直接使用第三方库watchdog。

实战案例一：使用watchdog库（跨平台首选）

1 安装

pip install watchdog

2 完整代码示例

import time
from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler
import os
class FileChangeHandler(FileSystemEventHandler):
    def on_modified(self, event):
        if event.is_directory:
            return
        # 只处理.py文件的变化
        if event.src_path.endswith('.py'):
            print(f"[修改] 文件: {os.path.abspath(event.src_path)}")
            # 这里可添加重启服务、触发测试等逻辑
    def on_created(self, event):
        if event.is_directory:
            return
        print(f"[新建] 文件: {os.path.abspath(event.src_path)}")
    def on_deleted(self, event):
        if event.is_directory:
            return
        print(f"[删除] 文件: {os.path.abspath(event.src_path)}")
if __name__ == "__main__":
    watch_path = "./watched_dir"  # 替换为你要监控的目录
    event_handler = FileChangeHandler()
    observer = Observer()
    observer.schedule(event_handler, watch_path, recursive=True)  # recursive=True递归监控子目录
    observer.start()
    print(f"开始监控目录: {os.path.abspath(watch_path)}")
    try:
        while True:
            time.sleep(1)
    except KeyboardInterrupt:
        observer.stop()
    observer.join()

3 运行效果

当你在watched_dir目录下新建、修改或删除文件时，控制台会实时打印变化信息，该代码支持递归监控所有子目录。

实战案例二：基于inotify的高性能监控（Linux专用）

如果服务器是纯Linux环境且监控文件数量极大（如10万+），watchdog的Python层开销仍显冗余，此时可直接调用Linux内核的inotify。

1 使用pyinotify库

pip install pyinotify

2 代码示例

import pyinotify
import os
class EventHandler(pyinotify.ProcessEvent):
    def process_IN_CREATE(self, event):
        print(f"创建: {event.pathname}")
    def process_IN_MODIFY(self, event):
        print(f"修改: {event.pathname}")
    def process_IN_DELETE(self, event):
        print(f"删除: {event.pathname}")
def monitor_with_inotify(path):
    wm = pyinotify.WatchManager()
    mask = pyinotify.IN_CREATE | pyinotify.IN_MODIFY | pyinotify.IN_DELETE
    handler = EventHandler()
    notifier = pyinotify.Notifier(wm, handler)
    # 添加监控目录，递归处理子目录
    wm.add_watch(path, mask, rec=True, auto_add=True)
    print(f"[inotify] 开始监控: {path}")
    notifier.loop()
if __name__ == "__main__":
    monitor_with_inotify("/tmp/watched_dir")

性能优势：inotify基于事件驱动，无轮询、无阻塞，单进程可同时监控数万文件。

常见问题与Q&A

Q1: 监控文件夹时，新建子文件夹内的文件变化能监听到吗？

watchdog：支持，将recursive=True参数传入schedule()即可递归监控所有子目录。
pyinotify：支持。rec=True启用递归，auto_add=True可自动监控新增的子文件夹。

Q2: 如何优化监控性能，减少不必要的回调？

过滤事件：通过event.src_path.endswith()只处理特定后缀文件。

去抖处理：某些编辑器（如Vim）保存文件时会触发多次修改事件，可用time.sleep(0.1)或实现简单的时间窗口过滤：

class DebounceHandler(FileSystemEventHandler):
  last_time = {}
  def on_modified(self, event):
      now = time.time()
      last = self.last_time.get(event.src_path, 0)
      if now - last < 0.2:  # 200ms内相同路径忽略
          return
      self.last_time[event.src_path] = now
      # 处理业务逻辑