科技 · 实用指南
Syncthing 提示“文件夹标记缺失”？重建 .stfolder 前先核对路径
这是一道安全停止，而不是让你盲目重建隐藏文件夹。先做只读预检，区分挂载丢失、路径移动、清理工具删除和权限故障，再恢复同步。
`.stfolder` 缺失之所以会中断同步，是因为 Syncthing 用它判断配置的文件夹是否真的存在且可读。否则，拔出的硬盘或失败的挂载可能会看起来像“所有文件都被删除”。
因此最安全的第一步不是新建标记。先冻结受影响端的改动，确认具体设备和配置路径，并证明预期目录树仍在，再进行任何写入。
本指南把官方的多个恢复分支整理成一张原因优先的检查表。它不能找回已经消失的字节，也不会把同步工具说成备份。
1. 先理解这道停止在保护什么
Syncthing 官方 FAQ 说明，默认标记是 `.stfolder`。程序检查它，是为了避免未挂载的文件系统、移除的 USB 硬盘或其他缺失存储被误认为全部文件都被主动删除。标记消失后，该文件夹会停止同步。
标记重新出现后，本地缺失内容可能再次作为删除同步出去。因此标记不是无害缓存；看到警告时，应先核对存储边界。
2. 冻结风险状态并找准报错端
暂时不要在多台设备上删除共享文件夹、重建 `.stfolder`、强制扫描或接受新共享。排查期间避免修改受影响目录；若另一台设备还有完整副本，把它保留为参照，并为重要数据另做备份。
记录真正报错设备上的四项信息：设备名、文件夹标签与 Folder ID、配置路径，以及 Send & Receive、Send Only 或 Receive Only 等文件夹类型。NAS 或容器还要同时记录容器内路径和宿主机映射。
3. 建立不写入的证据表
每个受影响端一行，记录报错设备、Folder ID、配置路径、预期磁盘或挂载、挂载是否存在、预期顶层子目录是否可见、已知哨兵文件、`.stfolder` 是否可见、服务用户、父目录写权限、最近日志和拟采用分支。
闸门很简单：不能证明配置路径指向目标存储，或看不到预期子目录树，就不要重建标记。旧挂载点下新出现的空目录即使路径文字相同，也不是原数据集。
4. 分支 A：硬盘或父级挂载缺失
如果预期硬盘、USB、网络共享或父文件系统没有挂载，先恢复该存储。核对卷身份或挂载目标，而不是只看同名目录是否存在；再抽查多个预期子目录和文件。
不要在空挂载点里创建 `.stfolder` 来“修复”缺失挂载。那会绕过安全检查，并可能把缺失目录树当成主动删除。挂载仍不稳定时，让 Syncthing 文件夹继续停止，单独修复存储或挂载服务。
5. 分支 B：完整文件夹被移动或改名
如果整个数据集连同标记都被有意移动，官方给出两条安全路线：移回配置位置，或只在受影响设备的 Syncthing 中移除该文件夹，再按新路径添加。前提是其他位置已有同步副本，且新位置包含完整目录树。
从 Syncthing 界面移除文件夹不等于删除磁盘文件，但仍要阅读当前版本的确认提示。只有要重新连接同一共享文件夹时才沿用原 Folder ID；接受远程共享前先核对本地路径，避免自动接受或封装工具选中未审计的默认目录。
6. 分支 C：所有预期文件都在，只有标记消失
清理工具可能删除空的 `.stfolder`，移动设备上尤其常见。只有当配置路径正确、目标存储已挂载且预期子目录齐全时，才适合重建标记。官方 FAQ 建议重建 `.stfolder` 并在其中放一个占位文件，或把标记加入清理排除。
先暂停清理工具，只在审计确认目录树完整的报错端创建标记，然后观察下一次扫描。若目录意外为空或不完整，立即停止；不要用标记重建来强行越过不确定性。
7. 分支 D：路径存在，但服务无法创建标记
日志若出现 `Failed to create folder marker`、`permission denied` 或指向错误目标，通常是访问问题。确认 Syncthing 的实际系统账号能遍历每一级父目录，并能写入准确目标；容器 NAS 还要从容器视角核对路径和宿主映射。
Windows 的“受控文件夹访问”可能阻止创建标记。论坛案例通过允许可信的 Syncthing 可执行文件解决，但应先确认日志中的受保护路径与程序身份。Linux 或 NAS 应修复目标服务账号的所有权、组或映射，而不是让整个应用以无限制管理员权限运行。
8. 原因仍不明时，只在故障设备上重新添加
官方的不确定分支是：只在受影响设备上从 Syncthing 移除该文件夹，再按同一已核实路径添加。这样会重置该设备对文件夹的数据库状态，并把本地文件与远端合并；只有在已核实本地目录树并保存重要数据备份时才算可控。
不要同时在所有设备上移除。保留一份已知良好副本并记下原 Folder ID。重新添加后，比较项目数量与多个哨兵文件；若远程共享落到默认路径，应取消并纠正本地路径，不能让新的空目录参与同步。
9. 验证恢复，但不要把同步当备份
恢复成功至少要满足三项：原报错端不再报错；证据表中的配置路径与 Folder ID 一致；扫描稳定后，多台设备上的代表性文件相符。恢复正常编辑前，检查最近更改是否出现异常删除。
Syncthing 文档明确指出它并不是理想的备份工具，因为修改和删除会传播。版本控制只能降低部分风险，不能替代独立备份。进行高风险路径、挂载或权限改动前，至少保留一份独立副本，并在证据表中记录日期和实际恢复动作。
