Syncthing文件冲突表现为同名多版本、含“conflict”后缀或同步停滞，需按五步解决：一、启用并识别冲突副本；二、手动合并内容；三、配置自动冲突保留策略；四、调整同步延迟与编辑习惯；五、用.stignore排除高冲突风险文件。

如果您在使用Syncthing同步文件时发现同一文件出现多个版本、名称含“conflict”后缀或同步状态异常停滞，则说明已触发文件冲突。以下是解决此问题的步骤：

一、启用并识别冲突副本

Syncthing默认在检测到并发修改时，会保留所有变更版本，并为冲突文件添加时间戳后缀（如note.md.conflict-20260413-152218），原始文件不受影响，确保数据不丢失。

1、打开Syncthing Web GUI，进入对应同步文件夹的“状态”页签。

2、查找标记为Conflicted的文件条目。

3、在文件系统中定位该文件所在目录，确认是否存在带.conflict-前缀的副本文件。

二、手动合并冲突内容

当需要保留双方修改时，必须人工比对并整合内容，这是最稳妥且不可替代的解决方式。

1、用文本编辑器（如VS Code、Notepad++或QOwnNotes）同时打开原始文件与冲突副本。

2、逐段比对差异，重点关注时间敏感段落（如待办事项、日期标记、代码块）。

3、将有效修改复制粘贴至新文件或主版本中，保存后删除冲突副本。

4、在Syncthing GUI中点击该文件旁的“重新扫描”按钮，使状态恢复正常。

三、配置自动冲突保留策略

通过调整Syncthing高级设置，可控制冲突文件的生成行为与命名规则，避免命名混乱或覆盖误操作。

1、进入Web GUI → “设置” → “高级” → 展开“冲突 Handling”区域。

2、勾选“启用冲突处理”，确保功能激活。

3、在“冲突文件名格式”栏输入：{{.Filename}}.conflict-{{.Timestamp}}（默认值，推荐保留）。

4、将“最大冲突副本数”设为3，防止历史冲突无限堆积。

四、调整同步延迟与编辑习惯

减少并发编辑概率，从源头降低冲突发生率。Syncthing本身不提供锁机制，需依赖用户行为与配置协同控制。

1、在设备A完成编辑后，立即点击Syncthing GUI中的“立即同步”按钮，等待状态变为“最新”再切换设备。

2、在Syncthing配置文件（config.xml）中，为对应文件夹添加以下字段：

<fsync><minSyncInterval>60</minSyncInterval></fsync>

3、将minSyncInterval值设为60秒以上，强制两次同步间至少间隔一分钟，缓冲本地未提交变更。

五、使用.stignore排除高冲突风险文件

对频繁变动、临时生成或非结构化内容文件主动屏蔽同步，规避无意义冲突。

1、在同步文件夹根目录创建或编辑.stignore文件。

2、添加以下典型规则行：

*.tmp

*.swp

.DS_Store

Thumbs.db

3、保存后，在Syncthing GUI中对该文件夹执行“重新扫描”，使规则即时生效。