文件夹同步

纯 Python 实现的文件夹同步工具，图形化界面配置，支持目录双向同步、单向镜像，按修改时间/大小/MD5 智能比较，原生跨盘同步，可定时自动同步。

核心特性

• 双向同步：两侧独有的内容互相复制，共同文件按修改时间/大小自动判断覆盖方向
• 单向镜像：目标侧多出的内容自动删除，保持与源目录完全一致
• 跨盘同步：源目录与目标目录可位于不同盘符（如 C: → D:），原生支持，无需额外配置
• NAS / 网络磁盘：支持同步到本地映射盘（如 Z:\）或 UNC 网络路径（如 \\nas\share\folder）
• 智能比较：按修改时间、文件大小或 MD5 决定是否覆盖
• 过滤规则：包含/排除通配符，精细控制同步范围
• 定时任务：配合盒子定时调度，无人值守自动同步
• 零依赖：纯 Python 标准库实现，无需安装任何外部工具

脚本演示

安装方法

本脚本的运行环境及图形化窗口均依赖"不忙脚本盒子"，建议仅通过盒子安装和使用本脚本。

前置条件：安装好 不忙脚本盒子

• 打开盒子 → 脚本市场 → 搜索 「文件夹同步」
• 点击「安装」

使用方式

• 直接启动
  • 在盒子里点击脚本卡片，弹出配置窗口
  • 「源目录」：填写要同步的文件夹路径（可跨盘，支持本地盘、NAS 映射盘、UNC 网络路径）
  • 「目标目录」：填写目标文件夹路径（可跨盘）
  • 「双向同步」：勾选 = 双向；不勾 = 单向镜像（目标侧多出的内容会被删除）
  • 需要时调整「比较策略」「包含/排除规则」等选项
  • 点击「执行」运行，结果打印在终端
• 定时任务
  • 在盒子中为该脚本创建定时任务
  • 在定时任务表单中同样填写源目录、目标目录等参数
  • 到点后盒子自动按填写内容执行同步
• 右键启动
  • 在文件管理器中选中文件夹，右键 → 文件夹同步
  • 在弹出的配置窗口中填写源目录、目标目录等参数后执行

💡 使用提示

• 单向镜像：目标目录与源目录完全一致，目标侧多出的文件/目录会被删除，请谨慎使用
• 双向同步：永不删除任何内容，只把两侧独有的文件互相复制、按比较策略覆盖共同文件
• 比较策略：默认按修改时间，较新一方覆盖；「按MD5」仅单向镜像可用
• 包含/排除规则：格式为 file:*.jpg,123.png;dir:folder1，file 部分匹配文件名，dir 部分匹配目录名，* 匹配任意字符
• 安全限制：源目录与目标目录不能相同、嵌套或重叠，脚本会直接拒绝执行
• NAS / 网络磁盘：源目录和目标目录均可直接填写本地映射盘路径（如 Z:\）或 UNC 网络路径（如 \\nas\share\folder）。若网络盘未连接或无访问权限，脚本会给出明确提示
• 相对路径：填写的相对路径以脚本安装目录为基准，建议直接使用绝对路径

🖥️ 环境要求