怎样用Python实现文件夹的增量同步_对比文件修改时间与大小-Python教程-PHP中文网

核心是用os.path.getmtime()和os.path.getsize()轻量比对文件修改时间与大小：大小不同必同步；大小相同但mtime不同仍需同步；两者均同则跳过，兼顾效率与准确性。

怎样用python实现文件夹的增量同步_对比文件修改时间与大小

用 `os.path.getmtime()` 和 `os.path.getsize()` 判断文件是否变更

增量同步的核心是快速识别哪些文件需要复制或更新。只比对修改时间（mtime）和大小（size）是最轻量、最常用的做法——它不读取文件内容，避免 I/O 开销，适合大多数场景。

但要注意：mtime 在某些系统（如 FAT32、网络挂载盘、Docker volume）上精度只有 2 秒；如果两个文件在同个 2 秒窗口内被修改，仅靠 mtime 可能漏判。所以必须同时检查 size：大小不同 → 肯定要同步；大小相同但 mtime 不同 → 仍需同步（比如重写但字节数巧合一致）；两者都相同 → 可跳过。

os.path.getmtime(path) 返回浮点秒数（Unix 时间戳），注意跨平台时 Windows 默认只保留 100ns 精度，但 Python 会自动对齐为 float，直接比较即可
os.path.getsize(path) 返回整数字节数，安全可比
若文件不存在或权限不足，这两个函数会抛 OSError，必须捕获，不能当作“未变更”处理

遍历源目录时用 `os.walk()` 但避免重复 stat

os.walk() 是标准做法，但它默认不提供文件元数据，每次调用 getmtime() 或 getsize() 都是一次系统调用。高频小文件场景下，这会明显拖慢速度。

更高效的方式是用 os.scandir()（Python 3.5+），它在遍历时就缓存了 stat() 结果：

Li Python Sec Check

Python 安全规范检查工具：基于 CloudBase 规范、腾讯安全指南，LLM 智能分析（默认禁用，优先本地执行）

下载

for entry in os.scandir(src_dir):
    if entry.is_file():
        # 直接用 entry.stat().st_mtime / st_size，无需再调 os.path.*
        mtime = entry.stat().st_mtime
        size = entry.stat().st_size

os.scandir() 比 os.walk() 快 2–20 倍（取决于文件数量和系统），且内存更友好
注意：entry.stat() 可能抛 FileNotFoundError（文件被删）或 PermissionError，需单独 try/catch
子目录仍需递归调用 os.scandir()，不能只靠一层遍历

目标目录不存在的文件直接复制，存在的则按时间/大小决策

同步逻辑不是“覆盖所有”，而是“最小动作”：新增文件 copy，变更文件 copy，删除文件（可选）rm，其余跳过。重点在于目标路径是否存在对应文件：

目标路径不存在 → 安全 copy（用 shutil.copy2() 保留 mtime 和权限）
目标路径存在且是文件 → 比较 src_mtime vs dst_mtime 和 src_size vs dst_size；只要任一不同，就 copy2
目标路径存在且是目录（而源是文件）→ 冲突，应报错退出，不自动覆盖
目标路径存在且是文件，但 src_mtime → 源更旧，通常跳过（除非强制单向同步）

别依赖 os.path.exists() 后再 os.path.isfile() —— 中间可能被删或改名，用 os.stat() 或 pathlib.Path.stat() 一次获取更稳。

用 `pathlib.Path` 管理路径拼接，避开 `os.path.join()` 的字符串陷阱

手动拼路径容易出错：Windows 用反斜杠、Linux 用正斜杠、末尾多一个 / 就导致 FileNotFoundError。用 pathlib 可读性高且自动归一化：

from pathlib import Path
src = Path("/data/src")
dst = Path("/backup")
dst_file = dst / src.relative_to(src.parent) / "file.txt"  # 自动处理分隔符

Path / str 运算符比 os.path.join() 更直观，也支持链式操作（如 p.with_suffix('.bak')）
relative_to() 是计算相对路径的关键，但如果源路径不在目标父目录下会抛 ValueError，需提前校验
创建目标目录时用 dst_file.parent.mkdir(parents=True, exist_ok=True)，避免 FileNotFoundError 因父目录缺失

真正难的不是判断逻辑，而是处理边界：符号链接是否跟随、硬链接如何识别、时区对 mtime 的影响、NFS 缓存导致的 stat 延迟……这些不显式处理，同步结果就不可信。