first commit

10-WebClipper/Syncthing 由「忽略模式」导致的同步异常 - Keenwon's Blog.md

@@ -0,0 +1,84 @@
+---
+title: "Syncthing 由「忽略模式」导致的同步异常 - Keenwon's Blog"
+source: "https://keenwon.com/syncthing-error-caused-by-ignoring-mode/"
+author:
+published:
+created: 2026-01-12
+description: "keenwon's blog"
+tags:
+  - "clippings"
+---
+[**Keenwon's Blog**](https://keenwon.com/)
+
+- [Home](https://keenwon.com/)
+- [Github](https://github.com/keenwon)
+- [Findit](https://keenwon.com/1436/)
+- [jqPaginator](https://jqpaginator.keenwon.com/)
+- [About](https://keenwon.com/about/)
+
+上周末遇到一个 Syncthing 同步的问题。在家里的台式机上，删除了一些没用的文件，大概 100MB，但是同步给笔记本的进度一直卡在 95% 左右。两台设备是通过海外的「中继」连接的，所以当时单纯以为是速度问题。
+
+但周一拿到笔记本之后，发现实际上是同步失败了，大概长这样（图是 [网上](https://forum.syncthing.net/t/folder-and-files-not-deleted-even-with-d-ignore-patterns-solved/18262) 找的）：
+
+![](https://keenwon.com/assets/image/f4904ed3.png)
+
+异常信息是：
+
+```bash
+delete dir: directory has been deleted on a remote device but contains ignored files (see ignore documentation for (?d) prefix)
+```
+
+查看了下 [忽略模式](https://docs.syncthing.net/v1.26.0/users/ignoring) 的文档，发现产生这个问题的原因是：假设有两台设备，windows 和 mac，同步的文件目录结构如下：
+
+```bash
+.
+├── a
+│   ├── 1.txt
+│   └── 2.txt
+├── b
+└── c
+```
+
+在使用过程中，mac 设备很容易产生 `.DS_Store` 文件，目录成了：
+
+```bash
+.
+├── 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)` 前缀来声明，该文件不影响目录的删除。
+
+```bash
+// Mac
+(?d)(?i).DS_Store
+(?d).project
+
+// Windows
+(?d)(?i)Thumbs.db
+(?d)(?i)ehthumbs.db
+(?d)(?i)Desktop.ini
+//群晖
+
+(?d)(?i)@eaDir
+
+
+```
+
+赞赏
+
+![](https://keenwon.com/assets/image/ba4f58a8.png)
+
+微信
+
+![](https://keenwon.com/assets/image/1a880e6d.png)
+
+本作品采用 [知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh) 进行许可