watchdog是python生态最成熟跨平台文件监听方案，自动适配windows readdirectorychangesw、linux inotify、macos fsevents，需用绝对路径监听、重写具体事件方法（如on_created）、处理临时文件与原子保存、用shutil.copy2保留元数据，并做好异常捕获与资源释放。
用 watchdog 监听文件系统事件最可靠
Windows 的 ReadDirectoryChangesW、Linux 的 inotify、macOS 的 FSEvents 底层机制差异大，自己封装容易漏事件或卡死。直接用 watchdog 是目前 Python 生态里最成熟的选择，它自动适配各平台，且能准确区分 created、moved、modified 等类型。
安装只需：
pip install watchdog注意不要装错成已停更的
Watchdog（首字母大写）或名字相近的其他包。关键点：
-
FileSystemEventHandler子类必须重写具体方法（如on_created），不能只写on_any_event——后者会把临时文件、编辑器备份等干扰事件全捕获，导致重复备份 - 监听路径要用绝对路径，相对路径在 daemon 化或不同工作目录下会失效
- 默认递归监听子目录，如只需顶层，传入
recursive=False
备份前先判断是否为“真正的新文件”
很多编辑器（如 VS Code、Sublime）保存时会先写临时文件再原子替换，触发两次事件：created（临时文件）→ moved（重命名覆盖原文件）。直接备份临时文件会导致损坏。
稳妥做法是：在 on_created 中检查文件扩展名和大小，再加短延迟确认稳定性：
import time
from pathlib import Path
<p>def on_created(self, event):
if event.is_directory:
return
p = Path(event.src_path)</p><h1>忽略 .tmp、~、.swp 等临时后缀</h1><pre class="brush:python;toolbar:false;">if p.suffix in {'.tmp', '.swp', '~'} or p.name.startswith('.'):
return
# 等待 100ms，确保写入完成（对小文件足够，大文件可延长）
time.sleep(0.1)
if not p.exists() or p.stat().st_size == 0:
return
self.backup_file(p)
不建议用 os.path.getmtime() 对比时间戳——NFS 或某些 USB 设备时钟不同步会导致误判。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
复制文件时用 shutil.copy2 而非 shutil.copy
备份不只是拿内容，还要保留原始文件的修改时间、权限等元数据，否则后续基于时间的增量同步或审计会出问题。
shutil.copy 只复制内容和部分权限；shutil.copy2 额外复制 atime、mtime 和 ctime（Linux/macOS 下 ctime 是状态变更时间）。
实操注意：
- 目标路径父目录必须存在，否则抛
FileNotFoundError，需提前Path(dest).parent.mkdir(parents=True, exist_ok=True) - 如果源文件正在被其他进程写入（如日志轮转中），
copy2可能读到截断内容，此时应捕获PermissionError或IOError并跳过 - 跨文件系统复制大文件时，
copy2比shutil.move更安全——后者在跨磁盘时本质是 copy+delete，失败则丢失原文件
长期运行必须处理异常和资源释放
监听进程跑几天后常因磁盘满、权限丢失、路径被删除而崩溃。裸跑 Observer 不会自动重连或清理。
核心防护点：
- 用
try/except包住observer.start()外层，捕获OSError（如监听路径消失）、KeyboardInterrupt（Ctrl+C） - 务必在退出前调用
observer.stop()和observer.join()，否则线程残留可能导致下次启动时报 “address already in use” 类似错误 - 加心跳日志，比如每 5 分钟打印一次当前监听路径和已处理文件数，方便排查静默挂起
真正难的是路径权限动态变化和网络共享文件夹的事件延迟——这些没有银弹，只能靠日志定位后手动加白名单或调整轮询间隔（timeout 参数）。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
