Syncthing 由「忽略模式」导致的同步异常

上周末遇到一个 Syncthing 同步的问题。在家里的台式机上，删除了一些没用的文件，大概 100MB，但是同步给笔记本的进度一直卡在 95% 左右。两台设备是通过海外的「中继」连接的，所以当时单纯以为是速度问题。

但周一拿到笔记本之后，发现实际上是同步失败了，大概长这样（图是网上找的）：

异常信息是：

delete dir: directory has been deleted on a remote device but contains ignored files (see ignore documentation for (?d) prefix)

查看了下忽略模式的文档，发现产生这个问题的原因是：假设有两台设备，windows 和 mac，同步的文件目录结构如下：

.
├── a
│   ├── 1.txt
│   └── 2.txt
├── b
└── c

在使用过程中，mac 设备很容易产生 .DS_Store 文件，目录成了：

.
├── a
│   ├── .DS_Store
│   ├── 1.txt
│   └── 2.txt
├── b
└── c

因为 .DS_Store 文件不需要同步给 windows，所以当 mac 忽略 .DS_Store 的同时，windows 删除了 a 目录，mac 端就会报错，同步失败。

原因其实也很简单，对于 Syncthing 来说，它只同步了 a/1.txt 和 b/1.txt，当 windows 删除 a 目录时，它知道 mac 侧有未纳入同步的文件 .DS_Store，所以就不能直接删目录。

这种情况是很常见的，一些工具经常在本地生成临时文件，针对这种情况，Syncthing 支持在定义忽略文件时，通过 (?d) 前缀来声明，该文件不影响目录的删除。

// Mac
(?d)(?i).DS_Store
(?d).project

// Windows
(?d)(?i)Thumbs.db
(?d)(?i)ehthumbs.db
(?d)(?i)Desktop.ini