提示「N 个文件无法同步」怎么办
一、先分清三种提示，只有一种才是真的「失败」
插件设置页「同步控制」下面那行字，是你了解同步状态的唯一入口。它有三类完全不同的含义，别把前两种当成故障：
| 状态行 | 含义 | 要不要处理 |
|---|---|---|
| 同步中 · N 个文件待重试 | 网络不好、连接闪断等临时问题，插件会自己一直重试 | 不用，网络恢复后自动补齐 |
| 未连接 / 未连接 · … | 当前连不上同步服务 | 检查网络；一般恢复后自动重连 |
| N 个文件无法同步 | 这几个文件再怎么重试也不会成功，需要你介入 | 要，本篇讲的就是它 |
插件有一条硬规矩：临时问题永远不会显示成「无法同步」。所以一旦看到「N 个文件无法同步」，说明确实卡住了，而且只有这 N 个文件受影响，其它文件照常同步。
「无法同步」的记录是按设备记的：哪台设备弹这个提示，就在哪台设备上处理。别的设备可能一切正常。
二、查出是哪个文件（2.5.0 及以上版本）
打开插件设置页：Obsidian 设置 → 第三方插件「手机电脑同步」。状态行下面会多出一个红边卡片，点「查看无法同步的文件（N）」展开：
展开后，每个同步不了的文件占一行，包含完整路径、人话原因、一行技术细节，以及三个按钮：
电脑端在同一位置，形态一样：
三、看懂原因，对症处理
人话原因只有两类，处理方式完全不同：
1. 「云端内容缺失或损坏，需要在其它设备重新保存这个文件」
云端存的那一份内容取不回来或校验不通过了，在这台设备上怎么重试都没用——本机没有这个文件的正确内容，只能从别处补。
正确做法：
- 找一台还有这个文件正确内容的设备（按列表里的完整路径找）；
- 在那台设备上打开它，随便改一下再改回来并保存（或者剪切全文、粘贴回去再保存），让它作为一个新版本重新上传；
- 回到弹提示的这台设备，点这一行的 「重试」。
如果所有设备上都没有这个文件的内容了，那这份内容确实已经不在了，可以直接用「排除此文件…」把提示清掉（见下一节），或到「找回已删除文件」里看看回收站还有没有。
2. 「需要你处理：可能是手机存储已满、没有写入权限，或超出容量限制」
问题在这台设备本机或你的云空间额度上：
- 手机/电脑存储已满 → 清出空间（手机可用插件设置页里的「立即清理本地附件腾空间」）；
- 没有写入权限 → 安卓上重新授权笔记库所在目录；
- 超出云空间限额 → 在网页管理页面查看用量，清理云端历史版本或加购空间。
处理完之后，回到列表点 「重试」。
点「重试」后，这一行会先消失，插件重新检查一遍。如果原因还没解决，它会如实地再出现——这不是 bug，是插件不肯谎报「已是最新」。
四、三个按钮分别做什么
- 重试 —— 把这个文件重新排进同步队列再试一次。原因解决后用它。
- 复制路径 —— 把完整路径复制到剪贴板，方便你去文件管理器里找它，或发给客服。
- 排除此文件… —— 让这台设备从此不再同步这个文件。点它会先弹确认框：
确认后提示立刻消失。要点：
- 排除不会删除任何东西：本机的文件原样留着，云端已有的副本也保留；
- 排除只作用于这一台设备，其它设备不受影响；
- 排除是可撤销的（见下一节）。
五、排除之后想反悔？
排除的记录会长期显示在同一个设置页的「排除的文件夹」这一行，点「管理…」即可取消排除：
取消排除后，这个文件会重新参与同步；如果当初的原因还在，它会再次出现在「无法同步」列表里。
六、如果你的版本还没有这块界面
上面这个可展开列表是 2.5.0 版本开始才有的。如果你的设置页只有「N 个文件无法同步」一行字、点不开：
- 等插件自动更新：插件会自行检查新版本并下载，重启 Obsidian 后生效；也可以到教程站首页重新下载安装包手动覆盖安装。
- 升级前的临时办法：设置页底部点 「导出日志」（手机是复制到剪贴板，电脑是下载文件），把内容发给客服协助定位。2.5.0 起，导出的日志开头会直接列出「无法同步的文件」清单，自助排查更方便。
七、常见问题
Q：一直提示，但我按路径去找，那个文件根本不存在？ 说明云端还留着这条记录、而本机确实没有它。用「排除此文件…」清掉提示即可，不会有任何数据损失。
Q：为什么在电脑上没提示，手机上一直提示？ 「无法同步」是按设备记录的。常见于手机存储满、权限被回收，或某台设备曾经下载到一半中断。在弹提示的那台设备上处理即可。
Q：点了「重试」，一会儿又变回「1 个文件无法同步」？ 说明底层原因还没解决（多半是云端那份内容还没被重新上传）。按第三节找一台有正确内容的设备重新保存一次，再点「重试」。
Q：排除之后，这个文件在别的设备上还会同步吗？ 会。排除只对你操作的那台设备生效。
Q：这几个文件卡着，会影响其它笔记同步吗？ 不会。插件会跳过它们，其余文件照常上传下载。