2.7 KiB
2.7 KiB
title, source, author, published, created, description, tags
| title | source | author | published | created | description | tags | |
|---|---|---|---|---|---|---|---|
| Syncthing 由「忽略模式」导致的同步异常 - Keenwon's Blog | https://keenwon.com/syncthing-error-caused-by-ignoring-mode/ | 2026-01-12 | keenwon's blog |
|
上周末遇到一个 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
//群晖
(?d)(?i)@eaDir
赞赏
微信
本作品采用 知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议 进行许可