为什么 Obsidian 笔记会在同步时重复或消失

Obsidian 的优势在于笔记就是你设备上的文件。vault 是一个可以查看、复制、备份和迁移的普通文件夹。

但这也是同步容易出问题的原因。

如果两台设备在拿到彼此最新修改之前编辑了同一篇笔记，同步工具就必须做决定：保留哪一份？是否两份都保留？是否创建冲突副本？如果它只是通用文件同步工具，它不一定知道这个文件是重要笔记、插件设置，还是临时工作区状态。

于是用户会遇到这些问题：

• Obsidian 笔记重复
• 出现 conflicted copy 文件
• 同步后笔记像是消失了
• iCloud 或 Dropbox 里的 vault 变乱
• 手机上看不到最新内容

大多数同步冲突不是随机发生的。理解常见原因后，可以避免很多麻烦。

什么是同步冲突

同步冲突是指同步系统无法安全地把多个文件版本合并成一个版本。

比如：

1. 你的笔记本电脑上有 Daily notes/2026-05-14.md。
2. 手机下载了这篇笔记。
3. 手机离线时，你在笔记本电脑上修改了它。
4. 手机上也修改了旧版本。
5. 两台设备重新联网。

现在，同一个路径下出现了两个真实的修改版本。同步工具无法完全知道你想保留哪一个。如果它静默选择其中一个，你可能丢失内容。如果它保留两份，你会看到重复文件或冲突文件。

重复文件看起来很烦，但有时反而更安全。看得见的冲突可以手动修复，悄悄覆盖则更难发现。

为什么 Obsidian vault 比普通文件夹更容易出问题

Obsidian vault 看起来像一个 Markdown 文件夹，但它比普通文件夹更活跃。

vault 里可能包含：

• Markdown 笔记
• 图片、PDF、音频等附件
• Canvas 文件
• 插件设置
• 主题和 CSS 片段
• 工作区布局
• 移动端专用设置
• .obsidian 里的隐藏文件

有些文件由你编辑，有些由 Obsidian 编辑，还有些由社区插件自动修改。你可能觉得自己没有改任何东西，但某个设置文件已经被重新写入了。

多数同步工具只看文件层面。它们看到的是“这个文件在这里变了”和“同一个文件在那里也变了”。它们不一定知道这是重要的笔记内容、临时布局变化，还是插件自动保存的设置。

常见原因

1. 同步还没完成就开始编辑

这是最常见的情况。

你在手机上打开 Obsidian，快速写了一条记录，后来才发现电脑上的最新版本还没上传。或者电脑从睡眠中唤醒后你马上开始写，而手机上的修改还没下载过来。

这些情况风险更高：

• 某台设备离线过一段时间
• 移动端后台同步延迟
• 大附件还在上传
• 你频繁在多台设备之间切换编辑
• 你使用需要手动 pull、push 或 sync 的方式

解决办法很简单，但有效：在第二台设备上编辑之前，先确认同步已经完成。如果同步工具有状态提示，就看状态提示。如果需要手动命令，就先执行 pull 或 sync，再开始写。

2. 同一个 vault 同时使用两个同步工具

不要让一个 vault 同时由多个同步系统管理，除非你非常清楚它们之间的行为。

尽量避免这些组合：

• Obsidian Sync 加 iCloud Drive 管同一个 vault
• Syncthing 加 Dropbox 管同一个 vault
• Git 自动同步加云盘同步管同一个文件夹
• 社区同步插件加外层文件同步文件夹

这种配置会让每个工具都以为自己掌握最新状态。结果可能是旧版本被重新同步回来、重复文件越来越多，或者你根本看不出哪个工具做了什么。

迁移同步方式时，先关闭旧方式。创建单独备份，确认新方式正常工作，然后再清理不需要的远程副本。

3. 不加区分地同步整个 .obsidian

.obsidian 文件夹保存 vault 配置，包括插件、主题、快捷键、代码片段、工作区状态和设备相关布局。

全部同步很方便。桌面端的插件和设置可以跟着到手机上。

但它也可能带来冲突。桌面布局不一定适合移动端。某些插件会频繁改写设置文件。你看到的冲突可能不是笔记内容，而是 workspace 文件。

这里没有唯一正确答案。关键是有意识地决定同步哪些内容。

如果你希望所有设备体验一致，可以同步大多数设置，但要观察反复冲突的文件。如果你希望每台设备有自己的布局，就应该在同步工具支持的范围内排除 workspace 或设备专用文件。

4. 插件文件和附件变化太快

这些文件可能频繁变化：

• 插件创建的数据库
• JSON 设置文件
• Canvas 文件
• 大型 PDF 或图片
• 捕获流程自动生成的笔记
• 自动化重命名的文件

变化越快，越难安全同步。移动设备休眠、网络切换、大文件上传慢于 Markdown 小文件时，问题尤其容易出现。

如果你经常添加大附件，切换到另一台设备编辑前要给它足够上传时间。如果某个插件会生成很大或经常变化的文件，也要确认它是否真的应该同步。

5. 文件名和路径在不同平台上表现不同

不同系统对文件名的处理并不完全一样。

常见风险包括：

• Ideas.md 和 ideas.md
• 包含保留字符或特殊字符的文件名
• 过长路径
• 只改变大小写的重命名
• 一台设备移动了附件，另一台设备仍引用旧路径

Obsidian 本身跨平台，但同步层仍然要处理 macOS、Windows、Linux、iOS 和 Android 的文件系统差异。

尽量让笔记名和附件名简单。如果跨平台同步，避免只改大小写的重命名。如果一定要把 ideas.md 改成 Ideas.md，可以先改成 ideas-temp.md，同步完成后再改成最终名称。

冲突文件一定是坏事吗？

不一定。

冲突文件说明同步工具没有直接用一个版本覆盖另一个版本。它很烦，但有时是在保护你的内容。

真正的问题不是出现冲突文件，而是你没有注意到它，无法判断哪一份更新，或者删除了错误的版本。

看到冲突时，可以这样处理：

1. 暂停在其他设备上编辑这篇笔记。
2. 打开两个版本。
3. 把缺失内容合并到你想保留的版本中。
4. 合并完成后再重命名或删除冲突文件。
5. 等最终版本完成同步后再切换设备。

如果同步工具有版本历史，删除任何内容前先查看历史。两份可见文件都让人困惑时，版本历史往往最有用。

如何让 Obsidian 同步更安全

你无法完全消除所有冲突，但可以显著降低概率。

保留独立备份

同步不是备份。

同步会复制变化。如果你误删一个文件夹，而删除操作同步到所有设备，同步工具会把这个错误也同步得很彻底。真正的备份应该给你另一个恢复点。

更换同步工具、移动 vault、启用会修改大量文件的插件之前，先在同步系统之外复制一份 vault。

切换设备前确认同步完成

可以养成这样的习惯：

• 在设备 A 上完成编辑。
• 确认设备 A 已经上传完成。
• 打开设备 B。
• 确认设备 B 已经收到最新变化。
• 再开始编辑。

这对 daily note、inbox note 和正在进行的项目笔记尤其重要。

一个 vault 只保留一个同步来源

如果你使用 Obsidian Sync，就不要把同一个 vault 再放进云盘同步文件夹。如果使用 Syncthing，就不要让 Dropbox 或 iCloud 同时管理这个文件夹。如果使用 Git，要小心自动 pull、push 与其他文件同步系统相互干扰。

一个 vault 应该只有一个明确的同步权威。

明确 .obsidian 的同步范围

.obsidian 是配置，不只是普通文件夹。

同步插件列表和基础设置通常很有用。但桌面端和移动端的 workspace 布局未必需要完全一致。插件数据库是否应该同步，则要看具体插件。

如果同一个设置文件反复冲突，先判断它是否真的需要在所有设备上一致。

优先选择有版本历史的同步方式

版本历史对 Obsidian 同步非常重要。

它能帮助你处理：

• 笔记被覆盖
• 文件夹被误删
• 错误合并导致内容缺失
• 插件一次性修改很多文件
• 几小时或几天后才发现问题

vault 越重要，就越不应该只依赖“最新文件获胜”的同步行为。

哪些同步方式更需要谨慎

任何同步方式都可能产生冲突。区别在于冲突是否可见、是否可恢复、是否容易理解。

iCloud Drive、Dropbox、Google Drive、OneDrive 这类通用云盘适合简单 vault，但它们不是为 Obsidian 行为专门设计的。

Syncthing 很适合点对点文件同步，尤其适合技术用户。但它同步的是文件，不是 Obsidian 的意图。你需要理解设备在线状态、冲突文件和排除规则。

Git 很适合历史记录和 diff，但对多数笔记工作流来说不是自然的自动同步方式。你需要处理 commit、pull、push 和 merge。

社区插件很灵活，但冲突行为取决于插件、存储后端和具体设置。

官方 Obsidian Sync 是集成度最高的付费方案。它支持端到端加密和版本历史，并且围绕 Obsidian 用户设计。

Synch 面向想要更低成本、开源、端到端加密 Obsidian 同步替代方案的用户。它关注的不只是把文件传到另一台设备，而是保持 vault 安全：加密同步、清晰状态和可通过版本历史恢复。

检查清单

在另一台设备上编辑同步 vault 前，先问自己：

• 上一台设备同步完成了吗？
• 当前设备已经收到最新变化了吗？
• 这个 vault 只用一种同步方式管理吗？
• 大改之前有备份吗？
• .obsidian 应该同步哪些内容已经决定了吗？
• 当前同步方式有版本历史吗？
• 如果出现冲突文件，我能先合并再删除吗？

如果几个问题都答不上来，写重要笔记前最好先停一下。

总结

Obsidian 同步冲突通常有明确原因。多设备、离线编辑、频繁变化的设置文件、大附件和重叠的同步工具，都会让同一个文件出现多个有效版本。

安全的 Obsidian 同步方式不只是速度快。它应该有清晰的同步来源，保护私人笔记，显示同步状态，保留恢复历史，并且在冲突出现时不要把问题藏起来。

vault 有价值，是因为它属于你。同步也应该保护这种控制权，而不是让它变得脆弱。