watchdog监听新增文件的核心逻辑是基于操作系统原生事件接口（inotify/FSEvents/ReadDirectoryChangesW）触发on_created事件，需结合event.is_directory == False和os.path.isfile()校验，并通过短时等待或监听on_moved规避编辑器临时文件。
watchdog监听新增文件的核心逻辑是什么
watchdog 不是轮询，而是依赖操作系统提供的文件系统事件接口（inotify / ReadDirectoryChangesW / FSEvents）。它只在真正有文件被创建、写入完成时才触发事件，所以必须监听 FileSystemEventHandler.on_created，而不是 on_modified 或 on_any_event。
注意：很多新手误以为新建一个空文件就立刻算“创建完成”，但实际编辑器（如 VS Code、Sublime）常先写临时文件再重命名，或分多次写入。此时你看到的可能是 on_created + 多次 on_modified，甚至只有 on_moved（因为底层是“原子写入”）。
关键判断依据是事件对象的 event.is_directory 和 event.src_path：
-
event.is_directory == False才代表是文件，否则是目录创建 -
os.path.isfile(event.src_path)建议额外校验一次，防止竞态（比如事件触发时文件还没完全落盘） - 如果需要等文件写完再处理（如读取内容），不能只靠
on_created，得加简单等待或用inotify的IN_CLOSE_WRITE语义模拟（watchdog 封装后对应on_closed_write，但仅 Linux 有效）
最简可用的监听脚本长什么样
下面这个脚本能稳定捕获用户手动新建、复制粘贴、下载完成的普通文件（不含编辑器临时行为）：
from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler
import time
import os
<p>class NewFileHandler(FileSystemEventHandler):
def on_created(self, event):
if not event.is_directory:</p><h1>等 100ms 让文件写入基本完成（对小文件足够）</h1><pre class="brush:php;toolbar:false;"> time.sleep(0.1)
if os.path.isfile(event.src_path):
print(f"✅ 新增文件: {event.src_path}")if name == "main": path = "." # 监听当前目录 event_handler = NewFileHandler() observer = Observer() observer.schedule(event_handler, path, recursive=False) observer.start() try: while True: time.sleep(1) except KeyboardInterrupt: observer.stop() observer.join()
说明：
-
recursive=False表示不递归监听子目录；设为True会监听整个树，但事件量剧增 -
time.sleep(0.1)是实用折中——比轮询轻，又避开大部分编辑器写入延迟；若处理大文件（如视频下载），建议改用os.stat().st_size轮询几秒确认大小不再变化 - 不要在
on_created里直接调用耗时操作（如上传、解析），应丢进队列或新开线程，否则会阻塞事件循环
为什么有时候 on_created 根本不触发
常见原因不是代码问题，而是路径或权限导致 watchdog 根本没起来：
- 监听路径不存在：
os.path.exists(path)必须为True，watchdog 不会自动创建目录 - Windows 上监听网络驱动器（如
Z:\）或 OneDrive 同步目录，部分事件被拦截或延迟极高 - Linux 下 inotify 限制：默认单用户最多监听 8192 个句柄，
observer.schedule()每个目录占 1 个，子目录多时会静默失败；查限制用cat /proc/sys/fs/inotify/max_user_watches，临时提高用sudo sysctl fs.inotify.max_user_watches=524288 - macOS 上监听
~/Downloads可能因 SIP 或隐私权限被拒，需在「系统设置 → 隐私与安全性 → 完全磁盘访问」中给终端/Python 添加权限
如何区分“真正新增”和编辑器的临时文件
VS Code、JetBrains 等默认用临时文件 + 重命名方式保存，你会看到类似这样的事件流：
on_created: /path/.myfile.py.swp on_created: /path/.myfile.py.tmp on_moved: src=/path/.myfile.py.tmp dst=/path/myfile.py
应对策略：
- 忽略以
.或~开头、或含.swp.tmp.part后缀的路径：os.path.basename(event.src_path).startswith((".", "~")) or any(event.src_path.endswith(ext) for ext in [".tmp", ".part", ".swp"]) - 重点信任
on_moved事件的dest_path—— 这才是最终落盘路径（但需确认event.is_directory == False） - 如果业务只关心“用户可见的新文件”，建议同时监听
on_created和on_moved，统一走dest_path或src_path的存在性校验
真正难处理的是那些既不临时、也不重命名，但分片写入的大文件（如浏览器下载）。这种场景下，on_created 只是开始，必须配合大小轮询或外部信号（如下载工具的完成回调）才能安全处理。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
